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C This manual describes the Hewlett-Packard 2780/3780 Emulator which is designed to run under the 
control of the HP 3000 Multiprogramming Executive (MPE/3000) Operating System. The Emulator makes 
it possible for you to exchange data between your HP 3000 Computer System and a variety of remote 
processors over the public telephone (switched) network or private leased lines. 


This manual assumes that you have a working knowledge of MPE/3000 and that you have some familiarity 
with either the IBM 2780 Data Transmission Terminal or the IBM 3780 Data Communication Terminal. 
Knowledge of the IBM Binary Synchronous Communications (BSC or Bisynch) line protocol conventions 
would be somewhat helpful but is not required. 


Throughout this manual the term “data set” is consistently used to mean a set of data (a group of related 
input or output records) and the term “MODEM” is consistently used to mean the piece of equipment that 
converts digital signals to tones (suitable for transmission over telephone lines) and tones to digital 
signals. 


This manual is arranged in five sections with ten appendices: 


e Section I summarizes the IBM 2780 and 3780 terminals and the Emulator and its environment. 





e Section II tells you how to initiate an Emulator run. 
e Section III describes the ten Emulator commands. 


e Section IV presents six annotated examples illustrating how you can use the Emulator in various 
situations. 


co e Section V describes the informational and error messages that can occur during an Emulator run. 
e Appendix A presents a comparison of the IBM 2780 and 3780 terminals. 


e Appendix B summarizes the options available for some typical MODEMs and indicates those options 
that are recommended (or required) for use with the Emulator. 


e Appendix C contains a tabulation of the ASCII, EBCDIC, and Hollerith character sets. 
e Appendix D summarizes the ten Emulator commands. 


e Appendix E tells you how to configure the Emulator. 





e Appendix F summarizes the error messages. 
e Appendix G shows an example of a procedure used with output commands. 


e Appendix H describes the CS/3000 Trace Facility that provides a record of line activities during 
Emulator operation. 


e Appendix I summarizes Binary Synchronous Communications line protocol control characters. 


e Appendix J explains the characteristics of Emulator files and how and when they are closed. 


This manual references the following manuals: 
f~ ® System Manager/System Supervisor Reference Manual, 30000-90014. 


© HP 30055A Synchronous Single-Line Controller, 30055-90001. 
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INTRODUCING THE 2780/3780 EMULATOR 





The Hewlett-Packard 2780/3780 Emulator lets you transfer 
data between your HP 3000 Computer System and a 
variety of remote processors in a full multiprogramming 
environment over the public telephone (switched) network 
or a private leased line. You can transfer data at rates of up 
to 9600 bits-per-second, depending upon your choice of 
MODEM. Higher transmission rates can be supported for 
certain applications. However, such determination must be 
made on an individual basis. 


The Emulator, which runs under the control of the HP 
3000 Multiprogramming Executive Operating System 
(MPE/3000), makes your HP 3000 Computer System ap- 
pear to the remote processor as either an IBM 2780 or 
3780 Data Transmission Terminal. The Emulator is more 
flexible than the IBM terminals in that it allows you to 
use a greater variety of input/output devices, including 
disc and magnetic tape. 


The remote processor can be any of the following: 
e 


Any computer which supports the IBM 2780 or 3780 
Data Transmission Terminals. 


An IBM 2780 or 3780. 


Another HP 3000 Computer System which is also using 
an HP 2780/3780 Emulator. 


You invoke the Emulator with the MPE :RJE command as 
described in section II. You can operate the Emulator in 
either the job (batch) or session (interactive) mode. Ten 
Emulator commands allow you to control the sequence of 
input/output processing. These commands are sum- 
marized in Table 1-1. 


Provided that your HP 3000 Computer System has more 
than one Synchronous Single-Line Controller, several 
people may use the Emulator concurrently. The number of 
concurrent users is limited by the number of Synchronous 
Single-Line Controllers which are available. Prior to 
invoking the Emulator, you can specify which Synchronous 
Single-Line Controller you wish to use through the use of an 
MPE file equation (this is described in Section II of this 
manual). 


IBM 2780 DATA TRANSMISSION 
TERMINAL 


1-1. 


The IBM 2780 Data Transmission Terminal was IBM’s 
original low-cost remote batch processing terminal and was 
the first data processor to use IBM Binary Synchronous 
Communications telecommunications line protocol 
(commonly referred to as BSC or bisynch). Physically, the 
IBM 2780 consists of the following hardware elements: 
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SECTION 


A control unit, a bisynch adapter, and buffers. 


A card reader capable of reading up to 400 cards-per- 
minute. 


A card punch (optional) capable of punching up to 355 
cards-per-minute. 


A line printer (optional) capable of printing up to 300 
lines-per-minute. 


Functionally, an IBM 2780 is capable of the following: 


e Transmitting or receiving in ASCII, EBCDIC, or six-bit 
transcode. 


e Accepting horizontal tabulation codes, thereby making 


it possible to process line printer output more efficiently 
(this capability is optional on the IBM 2780). 


Table 1-1. HP 2780/3780 Emulator Commands 


COMMAND FUNCTION 


# RJLINE Defines the characteristics of the communi- 
cations line. 














# RJIN Transmits input data from your HP 3000 


Computer System to the remote processor. 







#RJOUT Requests and processes routed output from 


the remote processor. 






#RJIO 


Initiates transmission of a one-line message 
to the remote processor. 






#RJINFO Initiates a file display printing of the com- 


munications line. 







#RJDEBUG Sets the Emulator into the debug mode. 





#RJLIST Requests and processes unrouted list output 


from the remote processor. 






#RJPUNCH Requests and processes unrouted punched 


output from the remote processor. 










#RJEOD Transmits an EOT control character (end- 


of-file) to the remote processor. 










#RJEND Terminates the HP 2780/3780 Emulator 


subsystem. 







The terms “routed” and “unrouted” refer to the pre- 
sence or absence of component select codes in con- 
junction with output transmitted from the remote 
processor. This concept is discussed in detail under 
the descriptions of the #RJOUT, #RJLIST, and 
#RJPUNCH commands in Section III, of this 
manual. 
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e Accepting vertical forms control codes, thereby facili- 
tating the formatting of line printer output. 


e Transmitting or receiving data in the transparent mode, 
thereby making it possible to transmit or receive binary 
data (this capability is optional on the IBM 2780 and 
applies only to the EBCDIC mode). Transparent mode 
is the transmission of binary data with no recognition of 
most control characters. 


e Performing short-record truncation. This makes it 
possible to suppress trailing blanks from card input, 
thereby increasing the transmission efficiency. How- 
ever, the user must indicate the start of each trailing 
blank field by including an EM control character in the 
data. 


e Transmitting or receiving blocked data, thereby in- 
creasing the transmission efficiency. The maximum 
number of records allowed per block is 2 (as an option, 
this maximum can be raised to 7). 


For a comparison of the IBM 2780 and 3780, see Appendix 
A of this manual. For a detailed description of the IBM 
2780, refer to Component Description: IBM 2780 Data 
Transmission Terminal (IBM SRL GA27-3005). 


1-2. IBM 3780 DATA COMMUNICATION 


TERMINAL 


Like the IBM 2780, the IBM 3780 Data Communication 
Terminal is a control unit with a set of input/output 
devices. Physically, the IBM 3780 consists of the following 
hardware elements: 


e A control unit, a bisynch adapter, and buffers. 


e A card reader capable of reading up to 600 cards-per- 
minute. 


e Acard punch (optional) capable of punching up to 359 
cards-per-minute. 

e A line printer capable of printing up to 425 lines-per- 
minute. 


Functionally, an IBM 3780 is capable of the following: 
e Transmitting or receiving in ASCII or EBCDIC. 


e Accepting horizontal tabulation codes, thereby making 
it possible to process line printer output more efficiently. 


e Accepting vertical forms control codes, thereby facili- 
tating the formatting of line printer output. 


e Transmitting or receiving data in the transparent mode, 
thereby making it possible to transmit or receive binary 
data (this capability is optional on the IBM 3780 and 
applies only to the EBCDIC mode). 
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@ Performing short-record truncation. This makes it 
possible to suppress trailing blanks from card input, 
thereby increasing the transmission efficiency. This 
function is performed automatically; the user does not 
need to include EM or IRS control characters in the data. 


e Compressing blank fields within the data, thereby in- 
creasing the transmission efficiency. The IBM 3780 does 
this automatically by replacing blank fields with a 
two-byte control sequence. 


e Transmitting or receiving blocked data, thereby in- 
creasing the transmission efficiency. The maximum 
number of records allowed per block is 216 in the non- 
transparent mode and 1 (optionally 6) in the transparent 
mode. 


e Interleaving the data passed between the communi- 
cations line and the input/output devices through the 
use of two 512-byte buffers, thereby increasing the over- 
all transmission efficiency. 


e Generating WACK (Wait-before-transmit ACKnowl- 
edgement) and TTD (Temporary Text Delay) control 
character sequences when it is temporarily unable to 
transmit or receive data. 


For a comparison of the IBM 2780 and 3780, see Appendix 
A of this manual. For a detailed description of the IBM 
3780, refer to Component Information for the IBM 3780 
Data Communication Terminal (IBM SRL GA27-3063). 


1-3. HP 2780/3780 EMULATOR 
CAPABILITIES 


The HP 2780/3780 Emulator provides the capabilities 
stated in paragraphs 1-1 and 1-2 plus the following: 


e When emulating an IBM 2780, it performs short- 
record truncation without the user having to supply 
EM control characters in the data. 


@ When emulating an IBM 2780, it can perform blank 
field compression. 


e@ When emulating either an IBM 2780 or 3780, it pro- 
vides input/output access to a greater variety of 
peripheral devices including disc and magnetic tape. 


e When emulating an IBM 2780, it can block more than 
7 records. 
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1-4. SYSTEM ENVIRONMENT 


The HP 2780/3780 Emulator is designed to run under the 
control of the HP 3000 Multiprogramming Executive 
(MPE/3000) Operating System. The Emulator requires the 
minimum HP 3000 Computer System configuration plus 
one of the following MODEMs or its equivalent: 


@ A Bell System Type 201A3 Data Set for 2000 bit-per- 
second (bps) transmission via the public telephone 
(switched) network. 


@ A Bell System Type 201B3 Data Set for 2400 bps 
transmission via a private leased line. 


1-3 
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A Bell System Type 201C Data Set for 2400 bps trans- 
mission via either the public telephone (switched) 
network or a private leased line. 


@ A Bell System Type 208A Data Set for 4800 bps trans- 
mission via a private leased line. 


@ <A Bell System Type 208B Data Set for 4800 bps trans- 
mission via the public telephone (switched) network. 


@ A Bell System Type 209A Data Set for 9600 bps trans- 
mission via a private leased line. 


The MODEM options recommended for use with the HP 
2780/3780 Emulator are presented in Appendix B of this 
manual. 


























OPERATING THE EMULATOR 





To operate the HP 2780/3780 Emulator, you must: 


1. Define any formal file designators which you will use 
during the job or session. 

2. Invoke the Emulator. 

3. Define the communications line. 


DEFINING YOUR FORMAL FILE 
DESIGNATORS 


2-1. 


If you will be using the form *formal file designator in the 
-R.JE command (described in paragraph 2-2) or in any of the 
Emulator commands, you must equate each formal file 
designator to an actual file designator, a logical device 
number, or a device class name by executing MPE :FILE 
commands (one for each formal file designator). Refer to the 
description of the :FILE command in the MPE Commands 
reference manual. 


2-2. INVOKING THE EMULATOR 


After you have defined the formal file designators, invoke 
the Emulator by issuing an MPE :RJE command. The for- 
mat of the :RJE command is as follows: 


:RJE [command file] 


,| input file] ie file} | punch | 


The parameters are defined in table 2-1. You must supply 
the parameters in the order shown above. If you wish to 
omit any of the first three parameters, you must include the 
associated comma(s). If you wish to omit all of the parame- 
ters, you can omit the commas altogether. If you wish to 
omit the last one, two, or three parameters, you can omit 
the associated comma(s). Some valid format examples are 
as follows: 


2-1 


SECTION 





‘RIE 

‘RJE command file 

-RJE ,input file 

‘RJE ,,list file 

‘RIE ,,, punch file 

:-RJE command file,,,punch file 
‘RJE ,input file, list file 


You can, either explicitly or by default, designate a single 
device or file as being both the command and input files. In 
such a case, the Emulator will switch back and forth be- 
tween the command and input modes when reading from 
the particular device or file. Initially the Emulator is in the 
command mode. In the command mode, all data read from 
the command/input file is interpreted as Emulator com- 
mands. When the Emulator encounters an #RJIN com- 
mand, it switches to the input mode. In the input mode, all 
data read from the command/input file is transmitted to the 
remote processor. When the Emulator encounters another 
command, it reverts back to the command mode, and so 
forth. 


As you will learn from Section III of this manual, you can 
also specify the input, list, and punch files in some of the 
Emulator commands. If you do, the file specification in the 
Emulator command overrides the corresponding one in the 
:RJE command. In other words, the input, list, and punch 
file specifications in the :RJE command apply only when 
the corresponding specification is omitted from an 
Emulator command. For example, if you omit the output 
file reference from an #RJOUT command, the list and 
punch files which you specified in the :RJE command will 
be used. 


2-3. DEFINING THE COMMUNICATIONS 


LINE 


The Emulator assumes that the communications line has 
the device class name RJLINE. If your HP 3000 Computer 
System does include the device class name RJLINE, then 
the communications line is already defined and you are not 
required to perform any further actions. If it does not in- 
clude RJLINE, then you must define the communications 
line by specifying the DEV parameter in the RJ LINE com- 
mand. This is performed when the RJLINE command pa- 
rameters are used to define the communications link bet- 
ween the Emulator and remote processor, as described in 
Section III. The user and account must have Communica- 
tion System (CS) capabilities to use the RJLINE command. 


Operating the Emulator 


30130C 


Table 2-1. :RJE Command Parameter Definitions 


FILE OR 


DEVICE FUNCTION 


File or device from which the 
Emulator reads HP 2780/3780 
Emulator directives. The di- 
rectives are described in Sec- 
tion III of this manual. 


command file 


File or device from which the 
Emulator reads input data to 
be transmitted to the remote 
computer. 


input file 


list file File or device to which list 
output received from the re- 
mote computer is to be 


routed. 


ALLOWABLE VALUES 


actual file designator 
*formal file designator 
$STDIN 

$STDINX 


actual file designator 
*formal file designator 
$STDIN 

$STDINX 


actual file designator 
*formal file designator 
SSTDLIST 
$OLDPASS 


FORMAL FILE 

DESIGNATOR 
USED 

BY EMULATOR 


DEFAULT 
VALUE 


$STDINX RJECOM 


$STDINX 


$STDLIST RJELIST 


SNEWPASS 


punch file File or device to which punch- 
ed output received from the 
remote computer is to be 


routed, 


actual file designator 
*formal file designator 
$0LDPASS 
S$NEWPASS 


SOLDPASS (if it 
exists; see Note) 
or $NEWPASS 


RJEPUNCH 


Emulator punch files are generally expected to have a file code of 1060 (decimal). If $OLDPASS exists, but has 
a file code other than 1060, then $NEWPASS is opened with a file code of 1060 and used. If you specify a 
punch file in the :RJE or #RJPUNCH commands, it may have any file code if it is an OLD file; if it is not an 
OLD file, the Emulator will open a NEW file with the specified name and with a file code of 1060. 


See Appendix J for input file characteristics. 


2-4. :RJE COMMAND EXAMPLES 


All of the examples below show you how to invoke the HP 
2780/3780 Emulator. They differ from one another only in 
how the various files are defined. 


Remember, you can redefine the input, list, or punch file for 


a specific input/output operation by supplying a file 
reference parameter in the particular Emulator command. 


2-5. USING DEFAULT VALUES 
To define all files by default, use the following :RJE 
command: 


‘RIE 


The files are defined as follows: 


$STDINX 
$STDINX 


e Command file: 


e Input file: 
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e List file: 


e Punch file: 


$STDLIST 


SOLDPASS (if it exists) or 
S$NEWPASS (if $SOLDPASS does not 
exist) 


2-6. USING DEVICE CLASS NAMES 

To define one or more of the files as device classes you must 
use MPE :FILE commands in addition to the :RJE 
command. 


Assume that LP and CP were defined at system generation 
time as the device class names for all line printers and card 
punches (respectively) in the system. To use LP and CP as 
file specifications in an :RJE command, you must first 
equate them to formal file designators as follows: 


:-FILE LIST; DEV=LP 
:>FILE PNCH; DEV=CP 


Note: You can use any formal file designators 
you wish. LIST and PNCH are used only 
for the purposes of this example. 
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To define the command and input files by default and the 
list and punch files as the device classes LP and CP 
(respectively), use the following :RJE command: 


‘RJE ,,*LIST,*PNCH 


The files are defined as follows: 


e Command file: SSTDINX 

e Input file: $STDINX 

e List file: The first available line printer in the 
system. 


The first available card punch in the 
system 


e Punch file: 


2-7, USING ACTUAL FILE DESIGNATORS 


Assume that ABC is the actual file designator for an 
existing file on disc. To define the command and input files 


as a single file (the file ABC) and the list and punch files 
by default, use the following :RJE command: 


_ :RJE ABC,ABC 


The files are defined as follows: 


e Command file: ABC 
e Input file: ABC 
e List file: $STDLIST 


$OLDPASS (if it exists) or 
$NEWPASS (if $OLDPASS does not 
exist) 


e Punch file: 


The file ABC contains the Emulator commands and the 
input data sets. Each #RJIN command must be 
immediately followed by the associated input data set. 
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Operating the Emulator 


2-8. USING LOGICAL DEVICE NUMBERS 

To define one or more of the files as specific devices, you 
must use MPE :FILE commands in addition to the :RJE 
command. 


Assume that, at system generation time, 21 was defined as 
the logical device number of an interactive terminal, 5 was 
defined as the logical device number of a card reader, and 
LP and CP were defined as the device class names for all line 
printers and card punches (respectively) in the system. To 
use 21, 5, LP, and CP as file specifications in an :RJE 
command, you must first equate them to formal file 
designators as follows: 


:FILE CMND; DEV=21 
:-FILEINPT; DEV=5 

:-FILE LIST; DEV=LP 
:FILE PNCH; DEV=CP 


Note: You can use any formal file designators 
you wish. CMND, INPT, LIST, and 
PNCH are used only for the purposes of 
this example. 


To define the command and input files as logical devices 
#21 and #5 (respectively) and the list and punch files as de- 
vice classes LP and CP (respectively), use the following 
:-RJE command: 


-RJE *CMND,*INPT,*LIST,*PNCH 


The files are defined as follows: 


@ Command file: Logical device #21 


e Input file: Logical device #5 

e List file: The first available line printer in the 
system. 

e Punch file: The first available card punch in the 


system. 
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The 10 HP 2780/3780 Emulator commands are sum- FUNCTION — describes briefly what the 
marized in Table 3-1 and are described in detail in this command can do. 
section. Emulator commands are used for two purposes: FORMAT — shows the format of the 
1. Todefine the necessary parameters for input and output command and briefly de- 

operations. fines the variables that you 
2. To control the sequence of HP 2780/3780 Emulator sass supply. 

input and output activities. DEFAULT VALUES — describes the default values 
An Emulator command is signified by a # character in the -_ ge paneer 
first position of the command record (batch job) or is COMMENTS = describes in detail the oper- 
prompted by a # character if the command file is your ation of the command and 
terminal (interactive session). In the latter case, when the implications of the 
entering an Emulator command do not enter another # various parameters. 
character; the prompt character serves as the first EXAMPLES — presents annotated ex- 
character of the Emulator command. amples of the command. 
This section was designed with the hope that it could be The first three topics are intended primarily as reference 
used for both learning and reference. With this in mind, the material. If, while perusing them, you are confused about 
following general format was chosen for presenting each some aspect of the command, refer to the “COMMENTS” 
Emulator command: and ‘“EXAMPLES”’ paragraphs. 


Table 3-1. HP 2780/3780 Emulator Commands 


COMMAND 
MNEMONIC MNEMONIC DEFINITION FUNCTION 


#RILINE Remote Job LINE Defines the communications link between the Emulator and the 
remote processor. 





















#RJIN Remote Job INput Defines the necessary parameters for a particular input operation 


and initiates the transmission of one input data set to the remote 
processor. 












#RIOUT 





Remote Job OUT put Defines the necessary parameters for a particular output operation 


(list and/or punch) and initiates the receipt of routed output from 
the remote processor. 







Remote Job Input Output Initiates transmission of a one-line message to the remote processor 


and initiates receive mode for the receipt of routed data from the 
remote processor. 














#RJINFO Remote Job Line 


Initiates a file display printing of the communications line. 
INFOrmation 









#RJDEBUG 





Remote Job DEBUG Seis the emulator into the debug mode, allowing the user access to 


the debugging facilities. 











#RJILIST Remote Job LIST 





Defines the necessary parameters for a particular list output oper- 
ation and initiates the receipt of unrouted list output from the 
remote processor. 












#RJPUNCH 





Remote Job PUNCH Defines the necessary parameters for a particular punched output 


operation and initiates the receipt of unrouted punched output from 
the remote processor. 






#RIEOD Remote Job End of Data Transmits an EOT (End Of Transmission) control character to the 


remote processor. 

















#RJEND 





Remote Job END Terminates the HP 2780/3780 Emulator subsystem. 
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3-2. FUNCTION 


The #RJLINE command defines the communications link 
between the Emulator and the remote processor. 


3-3. FORMAT 


#RJLINE emulator type 
_ JASCII 
| sanecove- ae 


_ JDIAL [,“phone scan 
connecr- ANSWER 


[;MAXRPB= blocking factor] 
[ID= terminal identification ] 
[;RIN=rin [ password ]] 
[;CHNL3=< | 


[;XEND] 


-STRACE= faun | [ mask | | [numentries | [, wear] 


7 . |YES|||.pp,_ | HIGH 
[;DEV =n] stock Falla fl 


#RJLINE emulator type 

emulator type specifies what type of data transmission 
terminal is to be emulated. It may be either of the fol- 
lowing: 


2780 
3780 


Note: Whenever you have the choice of emulat- 
ing either an IBM 2780 or 3780, you 
should be aware that the Emulator oper- 
ates more efficiently in the 3780 mode. 


;CONNECT = DIAL, phone number 

phone number is an ASCII character string consisting of 
numeric characters (0 through 9) and dash characters 
(-) enclosed within quotes not greater than 20 charac- 
ters long. The phone number entered is included as part 
of the dial message to notify the computer operator to 
dial the remote processor. In response to the dial mes- 
sage, the operator dials the remote processor and then 
enters YES or NO through the operator’s console, indi- 
cating whether or not the remote processor answered. 
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The entered phone number may include an area code. If 
so, the area code is followed by a dash and then by the 
telephone number. 


If phone number is omitted from the :CONNECT= 
DIAL parameter, the default phone number entered 
during Emulator configuration (see Appendix E) is used. 
Entering a phone number automatically overrides the 
default phone number. 


Note: Phone numbers, identification, and forms 


messages do not require quotes or delim- 
iters, and the quotes may be omitted. 


;MAXRPB=Dlocking factor 
blocking factor is a decimal integer specifying the maxi- 
mum number of records per transmission block. 


;[D=terminal identification 

terminal identification is an ASCII character string to be 
used as your terminal ID when the communications link 
is being established. This parameter should always be an 
ASCII character string. If the line code is specified as 
being EBCDIC(LINECODE=EBCDIC), the Emulator 
automatically converts the terminal identification from 
ASCII to EBCDIC. 


Note: This parameter should be used only when 


the remote processor requires a terminal 
ID. The Emulator transmits the terminal 
ID only if the Emulator initiates transmis- 
sion (i.e., only if the first operation is 
#RJIN rather than #RJOUT, #RJLIST, 
or #RJPUNCH). The Emulator always 
ignores a terminal ID sent by a remote 
processor. 


;RIN=rin [, password } 
rin is a valid global resource identiification number 
(RIN). 


password is a valid RIN password. 


Note: The use of global resource identification 


numbers is described under “Managing 
Resources through Identification Num- 
bers (RINS)” in the MPE Commands Sys- 
tem reference manual. 


;CHNL3=x 

x is a digit specifying a channel on a line printer car- 
riage control tape. Under MPE, channel 3 is always used 
for single spacing with a skip from bottom-of-form to 
top-of-form. The CHNL3=x parameter causes the Emu- 
lator to convert channel 3 codes received from the 
remote processor to whatever channel code (x) you 
specify. Of course it is assumed that the specified chan- 
nel on the line printer carriage control tape contains the 
sequence of punches expected by the remote processor. 
This responsibility is left up to you. 
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-XEND 

is a parameter for suppressing the CS ERR 158 printout. 
It is used when communicating with GE High-Speed 
Service to avoid an error printout when no error exists. 





Note: See Appendix H, CS/3000 Trace Facility, 
for a description of the following variables. 
sTRACE=ALL 


will generate trace records for all CREAD, CWRITE, 
CCONTROL and CCLOSE requests. If ALL is not 
specified, then trace records will be written only when a 
CREAD, CWRITE, CCONTROL or CCLOSE procedure 
is completed with a transmission error. 


‘TRACE=,mask 

mask is an octal integer preceded by a % sign (%nn) or 
an equivalent decimal number. It consists of a six-bit 
field representing the two-digit (nn) mask field. From 
bits 0 to 5 below (relative to the six-bit field), select the 
type of trace entries required and enter a % sign and the 
two octal numbers derived from the bit values or an 
equivalent decimal number: 





Bit 0 = Generate STN entries 
(octal 40) 


Bit 1 = Generate OPR and EDT 


entries (octal 20) First octal digit 





Bit 2 = Generate RCT entries 





(octal 10) 
Bit 3 = Generate RTX entries 
(octal 4) 
Bit 4 = een SCT entries Second octal digit 
Bit 5 = Generate STX entries 
(octal 1) 
Note: CMP entries are automatically generated. 
Setting bits 0 through 5 to 0 provides the 
default trace mask described below. 
*TRACE=,,numentries 


numentries is a decimal integer for the maximum num- 
ber of trace entries in a trace record, but not greater 
than 255. The CS trace file must be purged in order to 
allow a change in the number of entries (numentries). 


;sTRACE=,,,WRAP 
causes trace entries that overflow the trace area (greater 
than numentries) to overlay the prior trace entries. 


;DEV=n 

n is either the logical device number assigned to the com- 
munications line at system generation time or the device 
class name (other than RJLINE) assigned to the com- 
munications line at system generation time. 
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Note: Ifseveral Synchronous Single Line Con- 
trollers share the same device class 
name, the Emulator will use the first 
available one. 

3-4, DEFAULT VALUES 


Ifthe LINECODE= parameter is omitted from the RJLINE 
command, the default is the transmission code entered 
during configuration of the Emulator (see Appendix E). 


If the CONNECT= parameter is omitted, the default is 
DIAL and no dial message is issued. 


If the MAXRPB= parameter is omitted, the default is as 
follows: 


2780, non-transparent: 7 
2780, transparent: 4 
3780, non-transparent: 255 
3780, transparent: 6 
Note: Transparency or non-transparency is de- 


clared in the #RJIN command which is 
described in paragraphs 3-7 through 3-17 
of this manual. 


If the ID= parameter is omitted, the default is no ID trans- 
mission. 


If the RIN= parameter is omitted, the default is no RIN 
usage. 


If the CHNL3= parameter is omitted, the default is 8. 


If the XEND parameter is omitted, the default is an error 
condition when DLE EOT is received. 


If ALL is omitted from the TRACE= parameter, the default 
is that only I/O errors are traced. If mask is omitted, the 
default is generation of all entry types except STN. If 
numentries is omitted, the default is a maximum of 25 trace 
entries per trace record. If WRAP is omitted, the default is 
to discard overflow trace entries. 


If DEV= is omitted, the default is the opening of a device 
class called RJLINE. 


If the LOCK= parameter is omitted (or LOCK= YES), RJE 
locks the stack during activity. Refer to the Comments 
paragraph for information about the LOCK feature. 


If the PRI= parameter is omitted (or PRI= HIGH), RJE pri- 
ority is established by a call to GETPRIORITY. Conse- 
quently, RJE will have higher priority than the CS sub- 
queue. Refer to the Comments paragraph for information 
about the PRI parameter. 

3-5. COMMENTS 

The #RJLINE command is used only when a communica- 
tions link is to be established between the Emulator and a 
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remote processor. If you are merely using the Emulator for 
printing or punching output data sets from disc or magnetic 
tape, the #RJLINE command is not necessary and should 
be omitted. In this context, RJLINE refers to a communi- 
cations “line” and not to a line of code. The user must have 
Communication System (CS) capabilities to use the 
RJLINE command. 


The only required parameter is emulator type which speci- 
fies whether an IBM 2780 or 3780 is being emulated. 


The telephone connection can be established by dialing the 
remote processor via a MODEM or by receiving a call from 
the remote processor (either manually via a MODEM or 
automatically via an automatic answer capability). With a 
leased line or a switched line configured as a non-switched 
line, the connection is not broken after each call and redial- 
ing is not required. 


If a CONNECT= DIAL parameter includes a phone number, 
the Emulator prints a dial message on the operator’s con- 
sole immediately after execution of the first #RJIN, 
#RJOUT, #RJLIST, or #RJPUNCH command. The com- 
puter operator must then dial the number, complete the 
connection, and respond YES or NO to let the Emulator 
know whether or not the telephone connection was estab- 
lished successfully. In response to YES, the Emulator reads 
the next command (batch job) or displays a # on your ter- 
minal to prompt you for the next command (interactive 
session). In response to NO, the Emulator issues a CS9ERR1, 
o7 or 2,57 (see Section V for error codes). If the Emulator 
is ready to actually transmit or receive data and the line has 
not yet been established, the Emulator waits until the com- 
munications link is present. In such a case, the Emulator 
will wait up to 15 minutes (transmit or receive) for the 
“Data Set Ready” (CC) signal from the MODEM to become 
“set.” If “Data Set Ready” is not detected within the al- 
lowed time, the Emulator issues a CS ERR 1, 151 or 2, 151 
error message. 


If CONNECT= ANSWER is specified, the Emulator contin- 
ues processing. In session mode, if the Emulator is ready to 
actually receive or transmit data and the line has not been 
established, there is no timeout and the wait is infinite. In 
batch mode, the connect timeout is operational; ANSWER 
is enabled when the Emulator executes the first #RJIN, 
#RJOUT, #RJIJLIST, or #RJPUNCH command. If the con- 
nection is not established when the Emulator is ready to 
transmit or receive data, an abort is necessary to terminate. 


If the CONNECT= parameter is omitted, the Emulator 
continues processing. If the Emulator is ready to actually 
receive or transmit data and the line has not been estab- 
lished, the Emulator waits up to 15 minutes (receive or 
transmit) for “Data Set Ready” to become “set.” 

Note: CONNECT=DIAL implies that your HP 
3000 Computer System is the primary 
station and CONNECT=ANSWER im- 
plies that it is the secondary station. 
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Although the CONNECT= parameter is optional, its use 
eliminates the problem of determining the appropriate time 
to dial the host system. With this parameter, the operator 
dials and makes the connection immediately after he re- 
ceives the dial prompt (that is, immediately after the first 
#RJIN, #RJOUT, #RJLIST, or #RJPUNCH command 
executes). Without this parameter, dialing is performed at 
the same time but no prompt appears on the console. For 
this reason, always provide the CONNECT= parameter if 
an operator other than yourself must physically dial the 
telephone number. In addition, when using the #RJIN com- 
mand to satisfy the requirements of the CONNECT= 
parameter, a complete buffer must be sent from the Emu- 
lator subsystem to the driver. For a message or file which 
does not fill the buffer, an #RJEOD (or #RJIN, #RJOUT, 
#RJLIST, or #RJPUNCH) command must be specified 
before you dial the host system. 


If the ID= parameter is present, the Emulator transmits a 
terminal ID using the supplied terminal identification char- 
acter string. If the ID= parameter is omitted, no terminal 
ID is transmitted. The Emulator only transmits the terminal 
ID if the first input/output operation is #RJIN (no terminal 
ID is transmitted if the first input/output operation is 
#RIOUT, #RJLIST, or #RJPUNCH). The Emulator always 
ignores a terminal ID received from the remote processor. 


If the RIN= parameter is present, the Emulator attempts to 
perform a global lock (LOCKGLORIN) on the specified re- 
source identification number (RIN). If the RIN can be 
locked, processing continues. If the RIN is already locked, 
the Emulator waits for the RIN to become available. If you 
specify an erroneous RIN or password, the Emulator issues 
a RIN ERROR:0 error message (refer to Section V of this 
manual). The use of resource identification numbers is 
described under “Managing Resources through Resource 
Identification Numbers (RINS)” in the MPE Commands 
reference manual. 

Note: The RIN capability should be used when- 
ever the possibility exists that more than 
one job or session will try to use the same 
Synchronous Single-Line Controller at 
the same time. This could occur if a batch 
Emulator job enters the system while an 
Emulator session is in progress or when 
several batch Emulator jobs enter a sys- 
tem which has spooling capability. If the 
RIN capability is not used in such situa- 
tions, some of the Emulator jobs could be 
terminated by a CS ERR 0, 13 error con- 
dition. It should also be noted that the 
proper operation of the RIN capability 
requires the cooperation of all jobs and 
sessions which wish to use the particular 
communications interface; all must know 
the proper RIN to use and all must use it. 


If only I/O errors are to be traced, and ALL is not specified 
in the TRACE parameter, the trace facility deposits in the 
trace file only those records in which a line I/O error occur- 
red. 
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If WRAP is specified in the TRACE parameter, the trace 
entries are deposited in a trace record in a circular pattern. 
For example, if numentries specifies a maximum of 35 
trace entries per trace record, trace entries beyond the 35th 
will ovarlay the first, second (and so on) trace entries in the 
record. When this happens, the overlayed trace entries will 
be missing from the listing, a warning message will appear at 
the start of the record in the listing stating that the records 
are missing. 


If LOCK=YES or the LOCK=parameter is omitted, the 
RJE system locks its stack during activity. The LOCK=NO 
parameter allows the RJE stack to be managed like any 
other portion of memory (that is, Memory Management can 
swap the stack). The benefit of this is most evident in small 
memory configurations where there is contention between 
subsystems and programs with large stack requirements. 
The LOCK= parameter has no effect on the allocation of 
buffer space by the CS driver. When RJE is invoked, the 
driver allocates space as usual. 


If PRI=HIGH or the PRI=parameter is omitted, the pri- 
ority for RJE activity is established with a call to GETPRI- 
ORITY. The priority is 150 absolute in a linear subqueue 
(bottom of the BS and top of the CS queue). Because CS 
priority tends to drift down to the lower limit of the CS 
range, RJE tends to have higher effective priority than CS. 
The PRI=NORMAL parameter omits the call to GETPRI- 
ORITY and allows RJE to compete for priority in either 
session or batch mode like any other normal process. 


3-6. EXAMPLES 


#RJLINE 2780;LINECODE= ASCIL;TRACE= ALL,,128 


This command states that an IBM 2780 is to be emulated, 
the communications link is to be established by the com- 
puter operator dialing the remote processor via a MODEM, 
no terminal ID is to be transmitted, the transmission code 
is ASCII, the maximum number of records per transmis- 
sion block is either 7 (for non-transparent mode) or 4 (for 
transparent mode), all events (not just errors) will be traced 
with an %35 mask, and 128 entries per request can be made 
in the trace record (additional entries will be lost). 


#RJLINE 2780;ID= “MM” ;LINECODE= ASCII 


Same as above except that the Emulator is to transmit the 
terminal ID MM when the communications link is being 
established. Remember that the ID will be transmitted only 
if the first input/output command in the job or session is an 
#RJIN command. 


#RJLINE 3780;LINECODE= EBCDIC 
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This command states that an IBM 3780 is to be emulated, 
the communications link is to be established by the com- 
puter operator dialing the remote processor via a 
MODEM, no terminal ID is to be transmitted, the trans- 
mission code is EBCDIC, and the maximum number of 
records per transmission block is either 255 (for non- 
transparent mode) or 6 (for transparent mode). 


#RJLINE 2780;CONNECT= ANSWER; 
LINECODE= ASCII 


This command states that an IBM 2780 is to be emulated, 
the Emulator is to monitor the MODEM for an incoming 
call from the remote processor, no terminal ID is to be 
transmitted, the transmission code is ASCII, and the 
maximum number of records per transmission block is 
either 7 (for non-transparent mode) or 4 (for transparent 
mode). 


#RJLINE 3780;MAXRPB= 100;LINECODE= ASCII 


This command states that an IBM 3780 is to be emulated, 
the communications link is to be established by the com- 
puter operator dialing the remote processor via a 
MODEM, no terminal ID is to be transmitted, the trans- 
mission code is ASCII, and the maximum number of re- 
cords per transmission block is either 100 (for non- 
transparent mode) or 6 (for transparent mode). 


3-7, 
3-8. 


#RJIN 
FUNCTION 


The #RJIN command initiates the transmission of one 
input data set from your HP 3000 Computer System to the 
remote processor. The term “input data set” as used in this 
manual means the equivalent of an input card deck in an 
IBM 2780/3780 environment. The input data set can be 
read from an interactive terminal, punched cards, 
punched tape, a disc file, or a magnetic tape file. 


3-9. FORMAT 


#RJIN | input file reference | 


| ;REC= [ start rec | [end r ec] | 


_fvEs 
| compress-{t Z 


. _fYES 
[xranewr-{¥5 } 
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_SYES 

:reuncare- as } 
ASCII 

;INCODE={ EBCDIC 
BINARY 


[ ;MAXSIZE= nnn] 
[ ;:XEOF] 


Note: In all commands, Y and N can be used 


for YES and NO. 


#RJIN input file reference 
input file reference is any of the following: 


logical device number 
“device class name” 
actual file designator 
*formal file designator 


See Appendix J for input 
file characteristics. 


G 
@ procedurename |( {P| ) 
S 


Note: When G is specified, the libraries are 
searched in the following order: Group, 
Account Public, System. When P is 
specified, the libraries are searched in 
the following order: Account Public, Sys- 
tem. When S is specified or the parame- 
ter omitted, the System library is 
searched. 


If a user-supplied procedure is specified, it must adhere to 
the following format: 


INTEGER PROCEDURE procname(target); 
ARRAY target; 


The Emulator loads the procedure by issuing an MPE 
LOADPROC intrinsic call. The G, P, and S parameters are 
the equivalent of the 2, 1, and 0 lib parameters (respec- 
tively) of the LOADPROC intrinsic. The Emulator then 
calls the procedure. The procedure should move an input 
record into target and then return control to the calling 
program (i.e., the Emulator) passing a count (+ = words; 
— = bytes) and CCE. The Emulator transmits the record 
from target to the remote processor and then calls the 
procedure again. This continues until all input records 
have been transmitted, at which time the procedure 
should pass CCG to the Emulator. The maximum allowa- 
ble size of target is 400 bytes for 2780 emulation and 512 
bytes for 3780 emulation. 
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Note: The Emulator runs in the privileged 
mode. If you are supplying a procedure, 
it must be privileged. For a procedure to 
be privileged, you must have privileged 
capability and prepare (:PREP) the pro- 
cedure with the privileged mode. 


CAUTION 


If your procedure uses a significant 
amount of stack space (as an example, for 
procedure-local arrays), it may be neces- 
sary to increase the value of the STACK= 
parameter of the :PREP command in the 
installation file I00I130C.HP30130.SUP- 
PORT and install RJE with a larger stack. 
If the Emulator executes with its stack 
locked (that is, LOCK= NO is not speci- 
fied in the #RJLINE command) and the 
stack overflows, a SYSTEM FAILURE 
150 occurs. 


;REC= [start rec [,end rec] | 

start rec and end rec are MPE File System logical record 
numbers (not the values in positions 73-80 of the input 
records). These numbers must be positive integers. If 
both are present, start rec must be less than or equal to 
end rec. These parameters are used for transmitting a 
part of an MPE file. The first record in the file is record 
zero. 


>MAXSIZE= nnn 

is a parameter for extending the 80 byte limit on logical 
record size sent by the emulator, and is necessary to 
transfer USL files and program files between two HP 
3000’s. nnn is positive for length in words, with a maxi- 
mum of 128, and negative for bytes, with a maximum 
of -256. 


;X BOF 

causes the Emulator to not terminate after an input file 
read error. This allows inputs from “foreign” magnetic 
tapes and other media, where the end-of-file conventions 
do not conform to MPE standards. 


3-10. DEFAULT VALUES 

If the input file reference parameter is omitted from the 
#RJIN command, the one specified in the :RJE command 
is used. 


If end rec is omitted, all records beginning with start rec 
through the end of the input file are transmitted. If start rec 
is omitted, all records from the start of the file through and 
including end rec are transmitted. If the REC= parameter 
is omitted, the entire input file is transmitted. 
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If the COMPRESS= parameter is omitted, the default is 
NO for IBM 2780 emulation and YES for IBM 3780 
emulation. 


If the XPARENT= parameter is omitted, the default is 
NO (not transparent text). 


If the TRUNCATE= parameter is omitted, the default is 
YES. 


If the INCODE= parameter is omitted, the default is 
ASCII. 


If the MAXSIZE= parameter is omitted, the default is an 
80 byte limit on logical record size. 


If XEOF is omitted, the default is Emulator termination 
after an input file read error. 


3-11. COMMENTS 

3-12. GENERAL OPERATION. The #RJIN com- 
mand causes the immediate transmission of one input 
data set from your HP 3000 Computer System to the 
remote processor. The input data set may be read from an 
interactive terminal, a card reader, a punched tape reader, 
a disc file, or a magnetic tape file. If it is being read from a 
disc, you can specify starting and/or ending logical record 
numbers to transmit a part of that file. 


A single #RJIN command immediately followed by an 
#RJOUT, #RJLIST, #RJPUNCH, #RJEOD, or #RJEND 
command is the equivalent of reading one input card deck 
through an IBM 2780 or 3780 with the end-of-file key on. 


Two or more successive #RJIN command are the equiva- 
lent of reading that number of input card decks through 
an IBM 2780 or 3780 with the end-of-file key off. The first 
#RJOUT, #RJLIST, #RJPUNCH, #RJEOD, or #RJEND 
command following such a series of #RJIN commands 
implicitly performs the same function as turning the end- 
of-file key on during the reading of the final deck in the 
series. 


The transmission code (ASCII or EBCDIC) is specified in 
the #RJLINE command. The INCODE= parameter 
specifies what code the input data set is in prior to trans- 
mission (ASCII or EBCDIC). If the specified input code 
differs from the transmission code, the necessary conver- 
sion is done automatically by the Emulator. 
INCODE= BINARY specifies that no conversion is to be 
performed; the input data is to be transmitted bit-for-bit 
as it appears in the input file. 


Note: INCODE= BINARY implies no short- 
record truncation and no data compres- 
sion regardless of what is specified by 


the TRUNCATE= and COMPRESS= 
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parameters. INCODE= BINARY is ordi- 
narily used when the input process is 
being controlled by a user-supplied pro- 
cedure and you do not want the 
Emulator to do anything to the data 
other than transmit it. 


Entering a CONTROL-Y subsystem break signal from the 
terminal during an interactive session transfers control to 
the RJE command mode. The signal is transmitted by 
holding down the CTRL key and pressing the Y key. (See 
the MPE Intrinsics reference manual, section IV, under 
CONTROL-Y Traps.) When used with an output operation 
such as #RJOUT, #RJPUNCH, and #RJLIST, entering 
CONTROL-Y before output is received terminates the 
output command and returns to RJE command mode; en- 
tering after output is received sends EOT to the system 
transmitting (host system) and returns to RJE command 
mode. CONTROL-Y may also be entered when performing 
an #RJIN operation from the session input device. This 
will terminate the input operation and return to command 
mode, but will not cause buffered data or an EOT to be 
transmitted, as would be the case if #RJEOD were used to 
terminate input. 


3-13. DATA COMPRESSION. When data com- 
pression is being performed, the input records are com- 
pressed by having consecutive blanks transmitted as a 
two- byte sequence: a GS.or IGS control character followed 
by a count specifying how many blanks are being com- 
pressed. If you want data compression performed and an 
IBM 2780 is being emulated, you must specify 
COMPRESS= YES. Conversely, if you do not want data 
compression and an IBM 3780 is being emulated, you 
must specify COMPRESS= NO. 

Note: If INCODE=BINARY or XPARENT= 
YES is specified, no data compression 
will be performed regardless of what is 
specified by the COMPRESS= 
parameter. 


3-14. TRANSPARENT AND NON-TRANSPARENT 
MODES. The Binary Synchronous Communications 
(BSC) conventions require the use of certain control char- 
acters. (See Appendix I.) When ASCII or EBCDIC data is 
being transmitted, the user’s data ordinarily will not con- 
flict with the BSC control characters. However, when bi- 
nary data is being transmitted, certain bit sequences in 
the data could duplicate some of the BSC control charac- 
ters. If this were to happen, the transmission could be 
accidentally fouled up. To avoid this, the transparent 
mode was devised. In the non-transparent mode (the nor- 
mal mode of transmission), BSC control characters and 
data are intermixed: the data being supplied by the user 
and the BSC control characters being supplied by the 
communications interface. In the transparent mode, 
specified by XPARENT= YES, BSC control characters are 
sent as part of a two-byte DLE sequence: a DLE control 
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character followed by the particular BSC control charac- 
ter. In this case, the user’s data may contain any bit 
pattern (if it contains the bit pattern for a DLE control 
character, the Emulator transmits two successive DLEs). 
The transparent mode is used for sending binary data or 
for sending ASCII or EBCDIC data which must include 
BSC control characters as part of the data. 


3-15. SHORT-RECORD TRUNCATION. When 
short-record truncation is being performed, trailing 
blanks are automatically suppressed from input records. 
You need not include EM or IRS control characters in the 
data. However, EM and IRS control characters, if present 
in the data, will perform their intended function correctly 
(the Emulator will not alter such records). 


If TRUNCATE= NO is included in the # RJIN command, 
input records which are shorter than 80 bytes are padded 
with blanks to make 80-byte records. 

Note: If INCODE=BINARY or XPARENT= 
YES is specified, no short-record trunca- 
tion will be performed regardless of 
whether or not TRUNCATE= YES is 
specified. In the transparent mode, if a 
record is shorter than 80 bytes, it is pad- 
ded with blanks to make an 80-byte rec- 
ord. In the non-transparent mode with 
INCODE= BINARY, the data is not al- 
tered at all (it is neither truncated nor 
expanded). 


3-16. EXAMPLES 


#RJIN 6 


Assuming that 6 was defined at system generation time as 
the logical device number of a card reader, this command 
states that one input data set is to be read through the 
particular card reader and be transmitted to the remote 
processor. The following parameters are assumed by 
default: 


Transmit the entire input data set. 


Perform data compression if an IBM 3780 is being emu- 
lated; do not if an IBM 2780 is being emulated. 


Use the non-transparent mode. 
Perform short-record truncation. 


The input records are in ASCII format. 


#RJIN FILEG:REC=0,99:INCODE=EBCDIC 
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Assuming that FILE6 is the actual file designator of an 
existing file on disc, this command states that the first 100 
logical records of FILE6 are to be transmitted to the re- 
mote processor and that the input records are in EBCDIC 
format. The following parameters are assumed by default: 


e Perform data compression if an IBM 3780 is being 
emulated; do not if an IBM 2780 is being emulated. 

e Use the non-transparent mode. 

e Perform short-record truncation. 


#RJIN *INFILE;REC= 26,50 


Assuming the INFILE has been equated to an existing file 
on disc via an MPE:FILE equation, this command states 
that logical records 26 through 50 of the particular file are 
to be transmitted to the remote processor. The following 
parameters are assumed by default: 


e Perform data compression if an IBM 3780 is being 
emulated; do not if an IBM 2780 is being emulated. 
e Use the non-transparent mode. 


e Perform short-record truncation. 


The input records are in ASCII format. 
#RJIN @MYPROC(G);INCODE= BINARY 


This command states that the procedure MYPROC is to be 
executed and that no data conversion is to be performed. 
The Group Library, the Account Public Library, and the 
System Library (in that order) will be searched for the 
procedure MYPROC. The following parameters are as- 
sumed by default: 


e Do not perform data compression. 
e Use the non-transparent mode. 
e Do not perform short-record truncation. 


_#RJIN USLFILE;XPARENT= YES:MAXSIZE= 128 


This command states that an existing disc file name 
USLFILE is to be transmitted in transparent mode. The 
transmitted record size will be the record size read from 
the file or 128 words, whichever is the smaller. The follow- 
ing parameters are assumed by default: 


e Transmit the entire data set. 
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e Do not perform data compression. 
e Do not perform short-record truncation. 


#RJIN *IBMTAPE;XPARENT= YES; INCODE= BI- 
NARY;XEOF — | 


Assuming the IBMTAPE has been equated to a magnetic 
tape via an MPE:FILE equation, this command states that 
no data conversion is to be performed, data is to be trans- 
mitted in transparent mode and the Emulator is not to 
terminate on an input file error. The following parameters 
are assumed by default: 


e Do not perform data compression. 


e Do not perform short-record truncation. 


e Transmit the entire data set. 


#RJIN ;XPARENT= YES; INCODE= BINARY 


This command states that one input data set is to be read 
from the input file specified in the :RJE command and be 
transmitted to the remote processor in the transparent 
mode. No data conversion will take place. The above com- 
mand would most likely appear in a :JOB deck and be 
immediately followed by a binary data deck. The following 
parameters are assumed by default: 


e Transmit the entire input data set. 


e Do not perform data compression. 


e Do not perform short-record truncation. 


3-17. #RJOUT 


3-18. FUNCTION 

The #RJOUT command allows you to initiate the receipt 
of routed output data sets from the remote processor. The 
term “routed” means that each output record (for 2780 
emulation) or output data set (for 3780 emulation) is pre- 
ceded by an IBM 2780/3780 point-to-point component 
select code. Most remote job processing systems, such as 
IBM HASP/360, transmit routed output. The term “output 
data set” as used in this manual means a collection of 
records that are to be punched on cards, punched on paper 
tape, or printed on a line printer. The output data sets can 
be printed or punched directly as they are received or they 
can be stored in a disc or magnetic tape file for subsequent 
printing/punching off-line. The off-line processing must be 
performed by the #RJLIST and #RJPUNCH commands. 
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If the remote processor transmits routed output, you 
should use the # RJOUT command. If the remote processor 
transmits unrouted output or if you are printing/punching 


off-line from a disc or magnetic tape file, you should use 
the #RJLIST and #RJPUNCH commands. 


Note: The #RJOUT command will accept un- 
routed output but generally treats it as 
list output. 

3-19 FORMAT 


#RJOUT | output file reference] 


count | 
[;WAIT=[ m] [,s]] 
ASCII 
SOUTCODE= 4; EBCDIC 
BINARY 
[ ;OUTSIZE= nnn | 


#RJOUT output file reference 
output file reference is any of the following: 


See Appendix J for input 


file characteristics. 


logical device number 
“device class name” 


See Appendix J for input 


actual file designator 
file characteristics. 


*formal file designator 
G 
P}) 
s 


When G is specified, the libraries are 
searched in the following order: Group, 
Account Public, System. When P is 
specified, the libraries are searched in 
the following order: Account Public, Sys- 
tem. When S is specified or the parame- 
ter omitted, the System library is 
searched. 


(« procedurename |{ 


Note: 


Note that if output file reference is present, all output 
received will be passed (as list output) to that file or 
device. To have list output passed to one file or device and 
punched output passed to another, omit the output file 
reference parameter. In such a case, the list file and punch 
file specified, explicitly or by default, in the :RJE com- 
mand will be used. 
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If a user-supplied procedure is specified, it must adhere to 
the following format: 


PROCEDURE procname(target,count); 
VALUE count; INTEGER count; 
ARRAY target; 


The Emulator loads the procedure by issuing an MPE 
LOADPROC intrinsic call. The G, P, and S parameters are 
the equivalent of the 2, 1, and 0 lib parameters (respec- 
tively) of the LOADPROC intrinsic. The Emulator moves 
an output record into the array target and then calls the 
procedure. The size of the array target (expressed as a 
negative byte count) is passed as a value (count) in the 
procedure call. The procedure does what it wishes with the 
output record and then returns control to the calling pro- 
gram (i.e., the Emulator). This continues until all output 
records have been processed, at which time the Emulator 
ceases to call the procedure. (Appendix G contains an 
example of an output procedure.) 


Note: The Emulator runs in the privileged 
mode. If you are supplying a procedure, 
it must be privileged. For a procedure to 
be privileged, you must have privileged 
capability and prepare (:PREP) the pro- 


cedure with the privileged mode. 


CAUTION 


If your procedure uses a significant 
amount of stack space (as an example, for 
procedure-local arrays), it may be neces- 
sary to increase the value of the STACK= 
parameter of the :PREP command in the 
installation file I00I130C.HP30130.SUP- 
PORT and install RJE with a larger stack. 
If the Emulator executes with its stack 
locked (that is, LOCK= NO is not speci- 
fied in the #RJLINE command) and the 
stack overflows, a SYSTEM FAILURE 
150 occurs. 


#RJIOUT, count 
count is a decimal integer specifying how many output 
data sets are to be processed by this command. 


;WAIT= m 

m is a decimal integer specifying the maximum number 
of minutes the Emulator is to wait for each output data 
set. 


;WAIT= ,s 
s is a decimal integer specifying the maximum number of 
seconds the Emulator is to wait for each output data set. 
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Note: The m and s parameters, whether used 
individually or in combination, must not 
specify more than a 32767 second inter- 
val. In either case, the total “wait time” 
applies to any period of inactivity during 
the execution of the #RJOUT command. 
If, during the receipt of a data set or be- 
tween data sets, a period of inactivity 
occurs that exceeds the specified “wait 
time,” the Emulator issues a CS ERR 1, 
209 error message and then terminates 
the #RJOUT command. 


A WAIT=0 parameter 
Timeout. 


disables the 


‘OUTSIZE= nnn 

is a parameter for altering the division of received trans- 
parent 3780 blocks into logical records; the default for 
these logical records is 80 bytes. nnn is positive for 
length in words, with a maximum of 128, and negative 
for bytes, with a maximum of -256. 


3-20 DEFAULT VALUES 


If the output file reference parameter is omitted from the 
#RJOUT command, the list file and punch file are those 
set by the :RJE command. 


If the count parameter is omitted, one output data set is 
processed. 


If the m parameter is omitted, the Emulator will wait the 
number of seconds specified in the s parameter for each 
output data set. 


If the s parameter is omitted, the Emulator will wait the 
number of minutes specified in the m parameter for each 
output data set. 


If both the m and s parameters are omitted, the Emulator 
will wait three minutes for each output data set. 


If the OUTCODE= parameter is omitted, the default is 
ASCII. 


If the OUTSIZE= parameter is omitted, the default is an 
80 byte limit on logical record size. This is only significant 
when the Emulator is receiving transparent text in 3780 
mode, with the default causing the text to be arbitrarily 
divided into 80-byte records. 


3-21. COMMENTS 

3-22. GENERAL OPERATION. The #RJOUT 
command defines the necessary parameters for an output 
operation (list and/or punch) and initiates the operation 
immediately. As explained in paragraph 3-23 below, the 
output is expected to be routed. The #RJOUT command 


will accept unrouted output but generally treats it as list 


output. 





-) 
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Normally you should omit output file reference from the 
#RJOUT command. If it is included in the command, all 
output is treated as list output to be passed to that file or 
device. If it is omitted, list output will be passed to the list 
file specified in the :RJE command and punched output 
will be passed to the punch file specified in the :RJE 
command. 


The transmission code (ASCII or EBCDIC) is specified in 
the #RJLINE command. The OUTCODE= parameter 
specifies what code the output data sets are to be in when 
they are passed to the specified file or device (ASCII or 
EBCDIC). If the transmission code differs from the output 
code, the necessary conversion is done automatically by 
the Emulator. OUTCODE= BINARY specifies that no 
conversion is to be performed; the output data is to be 
passed to the appropriate file or device bit-for-bit as it was 
received (including the component select codes, which 
would otherwise be stripped off). OUTCODE= BINARY is 
ordinarily used when you are employing your own compo- 
nent select codes and the output is to be processed off-line 
at some later time by # RJLIST or #RJPUNCH under the 
control of a user-supplied procedure. 


Entering a CONTROL-Y subsystem break signal from the 
terminal during an iteractive session transfers control to 
the RJE command mode. The signal is transmitted by 
holding down the CTRL key and pressing the Y key. (See 
the MPE Intrinsics reference manual, section IV, under 
CONTROL-Y Traps.) When used with an output operation 
such as #RJOUT, #RJPUNCH, and #RJLIST, entering 
CONTROL-Y before output is received terminates the 
output command and returns to RJE command mode; en- 
tering after output is received sends EOT to the system 
transmitting (host system) and returns to RJE command 
mode. CONTROL-Y may also be entered when performing 
an #RJIN operation from the session input device. This 
will terminate the input operation and return to command 
mode, but will not cause buffered data or an EOT to be 
transmitted, as would be the case if # RJEOD were used to 
terminate input. 


3-23. ROUTED AND UNROUTED OUTPUT. Out- 
put data sets transmitted from the remote processor can be 
either routed or unrouted. The term “routed” means that 
each output record (IBM 2780) or each output data set 
(IBM 3780) is preceded by a component select code specify- 
ing whether the output is to be printed or punched. Most 
remote job processing systems, such as IBM HASP/360, 
transmit routed output. The #RJOUT command will cor- 
rectly process routed output that employs the IBM 2780 or 
3780 point-to-point component select conventions. 


If two HP 3000 Computer Systems are communicating 
with each other using HP 2780/3780 Emulators, you and 
the remote user can establish your own output routing 
capability. This is done by devising your own procedures 
for formatting and transmitting input and for processing 
output. Use the appropriate procedure names (@ proce- 
dure name) as the input and output file references in the 
#RJIN and #RJOUT commands. 
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If you are communicating with a remote processor which 
transmits unrouted output, you must know the order in 
which the output data sets are transmitted. Use the 
#RJLIST and #RJPUNCH commands, in the proper 


sequence, to receive unrouted output. 
CAUTION 


If the #RJOUT, #RJLIST, and 
#RJPUNCH commands are misued, 
data can be lost. 


The #RJOUT command treats al] un- 
routed data sets as list output. Thus if an 
unrouted punched output data set is 
processed by #RJOUT, the data is pas- 
sed to the list file or device and is no 
longer available from the remote proc- 


essor. 
3-24. EXAMPLES 
#RJOUT ,6 


This command states that six output data sets are to be 
received from the remote processor. List output data sets 
(routed or unrouted) and unrouted punched output data 
sets will be passed to the Jist file specified in the :RJE 
command; routed punched output data sets will be passed 
to the punch file specified in the :RJE command. After 
they are received, and before they are passed to the appro- 
priate file or device, the data sets will be converted to 
ASCII if they are not already in ASCII. By default, the 
maximum “wait time” is 3 minutes. 


#RJOUT 


This command is the same as the above example except 
that one output data set is expected. 


#RJOUT @ OUTPROC;OUTCODE= BINARY 


This command states that the user-supplied procedure 
OUTPROC is to be executed, and no data conversion is to 
be performed. The System Library will be searched for the 
procedure OUTPROC. By default, the maximum “wait 
time” is three minutes. 


#RJOUT OFILE,10;WAIT= 1,30 


This command states that ten output data sets are to be 
received from the remote processor, converted to ASCII if 
they are not already in ASCII, and stored in the file 
OFILE. Note that all output received (printed and 
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punched, routed and unrouted) will be treated as list out- 
put and be passed to the file OF ILE. If the file OFILE does 
not already exist, the Emulator will open a new file by 
that name and use it. The maximum “wait time” is 1 
minute, 30 seconds. 


3-25. #RUJLIST 
3-26. FUNCTION 


The #RJLIST command allows you to do the following: 


1. Initiate the receipt of unrouted list output data sets 
from the remote processor. The data sets can be 
printed directly on a line printer as they are received 
or they can be stored in a disc or magnetic tape file for 
subsequent printing off-line. 


2. Receive data sets routed to the line printer. 
3. Initiate the off-line printing of list output data sets 
which were received from a remote processor at some 


prior time and were stored in a disc or magnetic tape 
file. 


The #RJLIST command defines the necessary parameters 


for a particular list output operation and initiates the 
operation immediately. 


3-27. FORMAT 
#RJLIST | list file reference | 
[count | 
[;waIT= [m] [.s]] 
[ ;SSOURCE= source file reference] 
ASCII 


EBCDIC 
BINARY 


;OUTCODE= 


[ ;FFORMSMSG= message | 


oe 


[ SOUTSIZE= nnn | 


 avrorace- 


#RJILIST list file reference 
list file reference is any of the following: 


logical device number 
“device class name” 
actual file designator 
*formal file designator 


See Appendix J for input 
file characteristics. 


G 
@ procedurename|( ¢ P } ) 
S 
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Note: When G is specified, the libraries are 
searched in the following order: Group, 
Account Public, System. When P is 
specified, the libraries are searched in 
the following order: Account Public, Sys- 
tem. When S is specified or the parame- 
ter omitted, the search is in the System 
library. 


If a user-supplied procedure is specified, it must adhere to 
the following format: 


PROCEDURE procname(target,count); 
VALUE count; INTEGER count; 
ARRAY target; 


The Emulator loads the procedure by issuing an MPE 
LOADPROC intrinsic call. The G, P, and S parameters are 
the equivalent of the 2, 1, and 0 Jib parameters (respec- 
tively) of the LOADPROC intrinsic. The Emulator moves 
an output record into the array target and then calls the 
procedure. The size of the array target (expressed as a 
negative byte count) is passed as a value (count) in the 
procedure call. The procedure does what it wishes with the 
output record and then returns control to the calling pro- 
gram (i.e., the Emulator). This continues until all output 
records have been processed, at which time the Emulator 
ceases to call the procedure. 


Note: The Emulator runs in the privileged 
mode. If you are supplying a procedure, 
it must be privileged. For a procedure to 
be privileged, you must have privileged 
capability and prepare (:PREP) the pro- 


cedure with the privileged mode. 


CAUTION 


If your procedure uses a_ significant 
amount of stack space (as an example, for 
procedure-local arrays), it may be neces- 
sary to increase the value of the STACK= 
parameter of the :PREP command in the 
installation file I00I130C.HP30130.SUP- 
PORT and install RJE with a larger stack. 
If the Emulator executes with its stack 
locked (that is, LOCK= NO is not speci- 
fied in the #RJLINE command) and the 
stack overflows, a SYSTEM FAILURE 
150 occurs. 


#RJLIST, count 
count is a decimal integer specifying how many output 
data sets are to be processed by this command. 


;WAIT= m 

m is a decimal integer specifying the maximum number 
of minutes the Emulator is to wait for each output data 
set. 
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;WAIT= ,s 

s is a decimal integer specifying the maximum number of 

seconds the Emulator is to wait for each output data set. 
Note: The m and s parameters, whether used 
individually or in combination, must not 
specify more than a 32767 second inter- 
val. In either case, the total “‘wait time” 
applies to any period of inactivity during 
the execution of the #RJLIST command. 
If, during the receipt of a data set or be- 
tween data sets, a period of inactivity 
occurs that exceeds the specified “wait 
time,” the Emulator issues a CS ERR 1, 
209 error message to the operator’s con- 
sole and then terminates the #RJLIST 
command. 


A WAIT=0 parameter disables the Time- 
out. 


;SOURCE® source file reference 
is any of the following: 


logical device number 
“device class name” 
actual file designator 
*formal file designator 


‘ FORMSMSG= message 


initiates the MPE File System forms message (see 
MPE Intrinsics reference manual, section II, under 
FOPEN) when printing the received file. The message 
terminates with an optional period. 


;OUTSIZE= nnn 

is a parameter for altering the division of received 
transparent 3780 blocks into logical records; the de- 
fault for these logical records is 80 bytes. nnn is posi- 
tive for length in words, with a maximum of 128, and 
negative for bytes, with a maximum of -256. 


;AUTOPAGE= YES 

specifies that the FWRITE carriage controls of %40 
(single space), %60 (double space) or %304 (triple 
space) will be used where automatic page ejection is 
desired, but is not provided by the host system applica- 
tion. 


;sAUTOPAGE= NO 

specifies that FWRITE carriage controls of %201 
(single space), %202 (double space) or %203 (triple 
space) where automatic page ejection is provided by 
the host system application. 
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3-28. DEFAULT VALUES 

If the list file reference parameter is omitted from the 
#RJLIST command, the one specified in the :RJ E command 
is used. 


If the count parameter is omitted, one list output data set is 
processed. 


If the m parameter is omitted, the Emulator will wait the 
number of seconds specified in the s parameter for each 
output data set. 


If the s parameter is omitted, the Emulator will wait the 
number of minutes specified in the m parameter for each 
output data set. 


If both the yn» and s parameters are omitted, the Emulator 
will wait three minutes for each output data set. 


The source file reference parameter is used only for print- 
ing data sets off-line which were received from a remote 
processor at some prior time and were stored in a disc or 
magnetic tape file. There is no default value. 


If the OUTCODE= parameter is omitted, the default is 
ASCII. 


If the FORMSMSG= parameter is omitted, forms message 
is not used. 


Ifthe OUTSIZE= parameter is omitted, the default is an 80 
byte limit on logical record size when the Emulator is 
receiving transparent text as a 3780; in which case the 
default causes the text to be arbitrarily divided into 80-byte 
records. In all other cases, output record size is determined 
by the received data record size. 


If the AUTOPAGE= parameter is omitted, the default is no 
automatic page ejection when printing. 


3-29. COMMENTS 

3-30. ON-LINE OPERATION. The #RJLIST com- 
mand defines the necessary parameters for a particular list 
output operation and initiates the operation immediately. 
As explained in paragraph 3-32 below, the output is ex- 
pected to be unrouted. The output can be printed directly as 
it is received or it can be stored in a disc or magnetic tape 
file for subsequent printing off-line. 


The transmission code (ASCII or EBCDIC) is specified in 
the #RJLINE command. The OUTCODE= parameter 
specifies what code the output data sets are to be in after 
they are received (ASCII or EBCDIC). If the transmission 
code differs from the output code, the necessary conversion 
is done automatically by the Emulator. 
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OUTCODE= BINARY specifies that no conversion is to be 
performed; the output data is to be passed to the appro- 
priate file or device bit-for-bit as it was received. 


Entering a CONTROL-Y subsystem break signal from the 
terminal during an interactive session transfers control to 
the RJE command mode. The signal is transmitted by hold- 
ing down the CTRL key and pressing the Y key. (See the 
MPE Intrinsics reference manual, section IV, under 
CONTROL-Y Traps.) When used with an output operation 
such as #RJOUT, #RJPUNCH, and #RJLIST, entering 
CONTROL-Y before output is received terminates the out- 
put command and returns to RJE command mode; entering 
after output is received sends EOT to the system transmit- 
ting (host system) and returns to RJE command made. 
CONTROL-Y may also be entered when performing an 
#RJIN operation from the session input device. This will 
terminate the input operation and return to command 
mode, but will not cause buffered data or an EOT to be 
transmitted, as would be the case if # RJEOD were used to 
terminate input. 


3-31. OFF-LINE OPERATION. The #RJLIST com- 
mand defines the necessary parameters for a particular list 
output operation and initiates the operation immediately. 
The SOURCE= parameter specifies the file or device from 
which the output is to be read. The L, count, WAIT=, 
AUTOPAGE=, and OUTCODE= parameters have no mean- 
ing and should not be used. 


3-32, ROUTED AND UNROUTED OUTPUT. Out- 
put data sets transmitted from the remote processor can be 
either routed or unrouted. The term “routed” means that 
each output record (IBM 2780) or each output data set (IBM 
3780) is preceded by a component select code specifying 
whether the output is to be printed or punched. Most re- 
mote job processing systems, such as IBM HASP/360, 
transmit routed output. The #RJOUT command will cor- 
rectly process routed output that employs the IBM 2780 or 
3780 point-to-point component select conventions. 


Iftwo HP 3000 Computer Systems are communicating with 
each other using HP 2780/3780 Emulators, you and the 
remote user can establish your own output routing capabil- 
ity. This is done by devising your own procedures for for- 
matting and transmitting input and for processing output. 
Use the appropriate procedure names (# @ procedurename) 
as the input and output file references in the #RJIN and 
#RJOUT commands. 


If you are communicating with a remote processor which 
transmits unrouted output, you must know the order in 
which the output data sets are transmitted. Use the 
#RJLIST and #RJPUNCH commands, in the proper se- 
quence, to receive unrouted output. 


If you know that your host system will always return all list 
output sets followed by all punch output sets but are not 
sure of the number of each to be returned, enter a sequence 
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similar to the following to ensure retrieving all output data 
sets: 


#RJLIST “LP”,10 
#RJPUNCH PUNCHFILE,10 


If you now received not more than 10 list output sets fol- 
lowed by 10 punch output sets, they will have been cor- 
rectly processed. 


CAUTION 


If the #RJOUT, #RJLIST, and 
#RJPUNCH commands are misused, 
data can be lost. 


The #RJOUT command treats all un- 
routed data sets as list output. Thus if an 
unrouted punched output data set is 
processed by # RJOUT, the data is passed 
to the list file or device and is no longer 
available from the remote processor. 


If you are using the #RJLIST or #RJPUNCH command, 
and receive routed output that is inconsistent with the 
command, the Emulator will issue a routing error message 
and: 


1. If you are running the Emulator from an interactive 
session, you may now issue the appropriate # RJLIST 
or #RJPUNCH command. 


2. Ifyou are running the Emulator from a batch job, the 
emulator will read the command file until a command 
different from the erroneous # RJLIST or # RJPUNCH 
command is found. If the new command is now an 
appropriate # RJLIST, #RJPUNCH or #RJOUT com- 
mand, the output will be correctly processed. If the 
appropriate new command cannot be found, the 
Emulator will terminate and the output may be lost. 


3-33. EXAMPLES 


#RJLIST 4;OUTCODE= ASCII 


Assuming that 4 was defined at system generation time as 
the logical device number of a line printer, this command 
states that one list output data set is to be printed in ASCII 
on the particular line printer as it is received from the 
remote processor. By default, the maximum “wait time” is 3 
minutes. 


#RJLIST “LP”,3;0UTCODE= EBCDIC;WAIT= ,90 
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Assuming that LP was defined at system generation time 
as the device class name of all line printers in the system, 
this command states that three list output data sets are to 
be printed in EBCDIC on the first available line printer in 
the system. The maximum “wait time” is 90 seconds. 


#RJLIST “LP’:SOURCE= LIST 


Assuming that LP was defined at system generaton time as 
the device class name of all line printers in the system and 
LIST is the actual file designator of an existing file on disc, 
this command states that output data sets are to be read 
from the file LIST and be printed in ASCII on the first 
available line printer in the-system. 


3-34. #RJPUNCH 


3-35. FUNCTION 


The # RJPUNCH command allows you to do the following: 


1. Initiate the receipt of unrouted punched output data 
sets from the remote processor. The data sets can be 
punched directly on a card punch as they are received 
or they can be stored in a disc or magnetic tape file for 
subsequent punching off-line. 


2. Receive data sets routed to the punch. 


3. Initiate the off-line punching of punched output data 
sets which were received from a remote processor at 
some prior time and were stored in a disc or magnetic 
tape file. 


The #RJPUNCH command defines the necessary 
parameters for a particular punched output operation and 
initiates the operation immediately. 


3-36. FORMAT 


#RJPUNCH [ punch file reference] 
[ count] 
[|;WAIT=[m] [,s]] 
[;sSOURCE= source file reference] 
ASCII 


EBCDIC 
BINARY 


;OUTCODE= 


[ “OUTSIZE= nnn | 
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#RJPUNCH punch file reference 
punch file reference is any of the following: 


logical device number 
“device class name” 
actual file designator 
*formal file designator 


See Appendix J for input 
file characteristics. 


G 
(@ procedurename |i 4 P }» 
S 


Note: When G is specified, the libraries are 
searched in the following order: Group, 
Account Public, System. When P is 
specified, the libraries are searched in the 
following order: Account Public, System. 
When S§ is specified or the parameter 
omitted, the search is in the System 
library. 


If a user-supplied procedure is specified, it must adhere to 
the following format: 


PROCEDURE procname(target,count); 
VALUE count; INTEGER count; 
ARRAY target; 


The Emulator loads the procedure by issuing an MPE 
LOADPROC intrinsic call. The G, P, and S parameters are 
the equivalent of 2, 1, and 0/ib parameters (respectively) of 
the LOADPROC intrinsic. The Emulator moves an output 
record into the array target and then calls the procedure. 
The size of the array target (expressed as a negative byte 
count) is passed as a value (count) in the procedure call. The 
procedure does what it wishes with the output record and 
then returns control to the calling program (i.e., the 
Emulator). This continues until all output records have 
been processed, at which time the Emulator ceases to call 
the procedure. 

Note: The Emulator runs in the privileged 
mode. If you are supplying a procedure, it 
must be privileged. For a procedure to be 
privileged, you must have privileged 
capability and prepare (:PREP) the pro- 
cedure with the privileged mode. 


CAUTION 


If your procedure uses a significant 
amount of stack space (as an example, for 
procedure-local arrays), it may be neces- 
sary to increase the value of the STACK= 
parameter of the :PREP command in the 
installation file I001130C.HP30130.SUP- 
PORT and install RJE with a larger stack. 
If the Emulator executes with its stack 
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locked (that is, LOCK= NO is not speci- 
fied in the #RJLINE commana) and the 
stack overflows, a SYSTEM FAILURE 
150 occurs. 


#RJPUNCH, count 
count is a decimal integer specifying how many output 
data sets are to be processed by this command. 


;OUTSIZE=nnn 

is a parameter for altering the division of received trans- 
parent 3780 blocks into logical records; the default for 
these logical records is 80 bytes. nnn is positive for 
length in words, with a maximum of 128, and negative 
for bytes, with a maximum of ~256. 


-WAIT= m 

m is a decimal integer specifying the maximum number 
of minutes the Emulator is to wait for each output data 
set. 


;WAIT= ,s 
s is a decimal integer specifying the maximum number of 
seconds the Emulator is to wait for each output data set. 


Note: The m and s parameters, whether used 
individually or in combination, must not 
specify more than a 32766-second inter- 
val. In either case, the total ‘“‘wait time”’ 
applies to any period of inactivity during 
the execution of the #RJPUNCH com- 
mand. If, during the receipt of a data set 
or between data sets, a period of inactiv- 
ity occurs that exceeds the specified 
“wait time,’ the Emulator issues a CS 
ERR 1, 209 error message and then ter- 
minates the #RJPUNCH command. 


A WAIT=0 parameter disables the Time- 
out. 


‘SOURCES source file reference 
is any of the following: 


logical device number 
“device class name” 
actual file designator 
*formal file designator 


3-37. DEFAULT VALUES 


If the punch file reference parameter is omitted from the 
#RJPUNCH command, the one specified in the :-RJE 
command is used. 


If the count parameter is omitted, one punched output data 
set is processed. 
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If the m parameter is omitted, the Emulator will wait the 
number of seconds specified by the s parameter for each 
output data set. 


If the s parameter is omitted, the Emulator will wait the 
number of minutes specified by the m parameter for each 
output data set. 


If both the m and s parameters are omitted, the Emulator 
will wait three minutes for each output data set. 


The source file reference parameter is used only for 
punching data sets off-line which were received from a 
remote processor at some prior time and were stored in a 
disc or magnetic tape file. There is no default value. 


If the OUTCODE= parameter is omitted, the default is 
ASCII. 


Ifthe OUTSIZE= parameter is omitted, the default is an 80 
byte limit on logical record size when the Emulator is 
receiving transparent text as a 3780; in which case the 
default causes the text to be arbitrarily divided into 80-byte 
records. In all other cases, output record size is determined 
by the received data record size. 


3-38. COMMENTS 


3-39. ON-LINE OPERATION. The #RJPUNCH 
command defines the necessary parameters for a particular 
punched output operation and initiates the operation 
immediately. As explained in paragraph 3-41 below, the 
output is expected to be unrouted. The output can be 
punched directly as it is received or it can be stored in a disc 
or magnetic tape file for subsequent punching off-line. 


The transmission code (ASCII or EBCDIC) is specified in 
the #RJLINE command. The OUTCODE= parameter 
specifies what code the output data sets are to be in after 
they have been received (ASCII or EBCDIC). If the 
transmission code differs from the output code, the 
necessary conversion is done automatically by the 
Emulator. OUTCODE=BINARY specifies hat no 
conversion is to be done; the output data is to be passed to 
the appropriate file or device bit-for-bit as it was received. 


Entering a CONTROL-Y subsystem break signal from the 
terminal during an interactive session transfers control to 
the RJE command mode. The signal is transmitted by 
holding down the CTRL key and pressing the Y key. (See 
the MPE Intrinsics reference manual, section IV, uder 
CONTROL-Y Traps.) When used with an output oper 
tion such as #RJOUT, #RJPUNCH, and #RJLIST, 
entering CONTLCY before output is received terminates 
the output command and returns to RJE command mode; 
entering after output is received sends EOT to the system 
transmitting (host system) and returns to RJE command 
mode. CONTROL-Y may also be entered when performing 
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an #RJIN operation from the session input device. This 
will terminate the input operation and return to command 
mode, but will not cause buffered data or an EOT to be 
transmitted, as would be the case if #RJEOD were used to 
terminate input. 


3-48. OFF-LINE OPERATION. The #RJPUNCH 
command defines the necessary parameters for a particular 
punched output operation and initiates the operation 
immediately. The SOURCE= parameter specifies the file 
or device from which the output is to be read. The count, 
WAIT=, and OUTCODE= parameters have no meaning 
and should not be used. 


3-41. ROUTED AND UNROUTED OUTPUT. 
Output data sets transmitted from the remote processor 
can be either routed or unrouted. The term “routed” means 
that each output record (IBM 2780) or each output data set 
(IBM 3780) is preceded by a component select code 
specifying whether the output is to be printed or punched. 
Most remote job processing systems, such as IBM 
HASP/360, transmit routed output. Use the #4RJOUT 
command to correctly process routed output that employs 
the IBM 2780 or 3780 point-to-point component select 
conventions. 


If two HP 3000 Computer Systems are communicating with 
each other using HP 2780/3780 Emulators, you and the 
remote user can establish your own output routing 
capability. This is done by devising your own procedures for 
formatting and transmitting input and for processing 
output. Use the appropriate procedure names 
(@procedurename) as the input and output file references 
in the #RJIN and #RJOUT commands. 


If you are communicating with a remote processor which 
transmits unrouted output, you must know the order in 
which the output data sets are transmitted. Use the 
#RJLIST and #RJPUNCH commands, in the proper 
sequence, to receive unrouted output. 


If you know that your host system always returns all list 
output sets followed by all punch output sets but are not 
sure of the number of each to be returned, enter a sequence 
similar to the following sequence in a batch job to ensure 
retrieving all output sets: 


#RJLIST “LP”,10 
#RJPUNCH PUNCHFILE,10 


If you receive not more than 10 list output sets followed by 
10 punch output sets, they will have been correctly 
processed. 


CAUTION 


If the #RJOUT, #RJLIST, and 
#RJPUNCH commands are misused, 
data can be lost. 


3-17 


Writing HP 2780/3780 Emulator Command 


The #RJOUT command treats all un- 
routed data sets as list output. Thus if an 
unrouted punched output data set is pro- 
cessed by #RJOUT, the data is passed to 
the list file or device and is no longer 
available from the remote processor. 


If you are using the #RJLIST or #RJPUNCH command, 
and receive routed output that is inconsistent with the 
command, the Emulator will issue a routing error message 
and: 


1. If you are running the Emulator from an interactive 
session, you may now issue the appropriate #RJLIST 
or #RJPUNCH command. 


2. If you are running the Emulator from a batch job, the 
Emulator will read the command file until a command 
different from the erroneous #RJLIST or #RJPUNCH 
command is found. If the new command is now an 
appropriate #RJLIST, #RJPUNCH or #RJOUT com- 
mand, the output will be correctly processed. If the 
appropriate new command cannot be found, the 
Emulator will terminate and the output may be lost. 


3-42. EXAMPLES 


#RJPUNCH 6,0UTCODE=BINARY 


Assuming that 6 was defined at system generation time as 
the logical device number of a card punch, this command 
states that one punched output data set is to be punched on 
the particular card punch as it is received from the remote 
processor and that no data conversion is to be performed. 
By default, the maximum “wait time” is 3 minutes. 


. #RJPUNCH “CP”,2;0UTCODE=EBCDIC;WAIT=2 


Assuming that CP was defined at system generation time 
as the device class name for all card punches in the system, 
this command states that two punched output data sets are 
to be punched in EBCDIC on the first available card punch 
in the system as they are received from the remote 
processor. The maximum “wait time” is 2 minutes. 


" #RJPUNCH ;SOURCE=PNCH > 


Assuming that PNCH is the actual file designator of an 
existing file on disc, this command states that output data 
sets are to be read from the file PNCH and be passed to the 
file or device specified by the punch file parameter in the 
-RJE command. 
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#RJPUNCH PNCH;WAIT=,90 


This command states that one punched output data set is to 
be passed to the file PNCH on disc as it is received from the 
remote processor. If the file PNCH does not already exist, 
the Emulator will open a new file by that name and use it. 
The maximum “wait time” is 90 seconds. 


_ #RJPUNCH USLFILE;OUTSIZE=128 


This command states that one output data set will be 
passed to the disc file USLFILE. Assuming that the 
Emulator is in 3780 mode and that the transmitting station 
is sending transparent records with MAXSIZE= 128, the 
use of this parameter will allow the transfer of 128-word 
records. 


3-43. #RJEOD 
3-44. FUNCTION 


The #RJEOD command transmits any remaining data 
buffered by the Emulator and an EOT (End Of 
Transmission) control character to the remote processor. 


3-45. FORMAT 
The format of the #RJEOD command is as follows: 
#RJEOD 


3-46. COMMENTS 

Normally you will not use the #RJEOD command because 
the Emulator automatically transmits an EOT whenever 
an #RJOUT, #RJLIST, #RJPUNCH, or #4RJEND 
command is encountered following an #RJIN command. 


If you issue a series of #RJIN commands, the input data 
sets associated with the commands are sent together as a 
single transmission with no intervening EOT control 
characters. When an #RJOUT, #RJLIST, #RJPUNCH, or 
#RJEND command is subsequently encountered, the 
Emulator then sends an EOT. 


You will normally use an #RJEOD command only when 
the operating characteristics of the remote processor 
require that an EOT be transmitted and the Emulator 
would not otherwise transmit one. Two examples are as 
follows: 


1. Some remote job processing systems require that the 
“log-on” card be immediately followed by an EOT 
control character. To accomplish this, use the following 
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command sequence: 


#RJIN ;TRUNCATE=NO 
/*SIGNON REMOTEnn 
#RJEOD 


Some remote job processing systems require that each 
input data set be terminated by an EOT control 
character. If you are issuing successive #RJIN 
commands and wish to terminate each input data set 
with an EOT, use the following command sequence: 


#RJIN (parameters) 
#RJEOD 
#RJIN (parameters) 
#RJEOD 
#RJIN (parameters) 
#RJEOD 


Sometimes when an error condition occurs, you may be in 
doubt as to what the current state of the communications 
line is. In such a case, you can return the line to a known 
state (the “control” state) by transmitting an EOT control 
character. 


3-47. #RJEND 


3-48. FUNCTION 

The #RJEND command terminates the HP 2780/3780 
Emulator subsystem. The messages that are issued in 
conjunction with this command are described in Section V 
of this manual. 


3-49. FORMAT 


The format of the #RJEND command is as follows: 


#RJEND 


3-50. #RJIO 


3-51. FUNCTION 

The #RJIO command applies to special situations where a 
one-line message is sent and a variable number of lines are 
received in response to the message. An example isa/*$DA 
sent to an IBM HASP/370 system. 


An #RJIO message is equivalent to the following sequence: 


#RJIN 

message 

#RJEOD 

#RJOUT ;WAIT=3 
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The following two examples are equivalent to the above 
sequence: 


#RJIO message 


#message (only in an interactive session, where the 
message starts with a special character) 


The above sequence is equivalent to a #RJIO message but 
the RJIO may be omitted for convenience. The message in 
this case must have a special character, not a letter or digit, 
in column one. 


3-52. FORMAT 

#RJIO message (Batch) 

#[RJIO] message (Session, where the first character of 
message is a special character.) 


Thus, to send a -$DA message to a HASP system and 
receive the response, the following four formats are 
equivalent: 

1. #RJIN 

FSDA 
#RJOUT;WAIT=3 


#RJIN 

FFSDA 

#RJEOD 
#RJOUT;WAIT=3 
#RJIO *$DA 


#/*$DA (only in an interactive session) 
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3-53. #RJINFO 


3-54. FUNCTION 

The #RJINFO command initiates a line display printing of 
the communications line. A display box prints on 
$STDLIST as an aid in diagnosing problems. 


3-55. FORMAT 


#RJINFO 


Appendix H contains an example of a line display printing 
and an explanation of the entries. 


3-56 #RJDEBUG 


3-57. FUNCTION 

The #RJDEBUG command sets the Emulator into the 
debug mode, allowing the user access to the debugging 
facilities as a diagnostic aid. (See the MPE DEBUG/Stack 
Dump reference manual.) This command should be used 
only in debugging user-written input and output 
procedures. 


3-58. FORMAT 
The format of the #RJDEBUG command is as follows: 


#RJDEBUG 
























The examples in this section show you how to write and 
execute Emulator command sequences that allow your HP 
3000 Computer System to communicate with the following 
remote processors: 


1. A remote job processing system such as IBM 
HASP/360. 


2. An IBM 2780. Data Transmission Terminal. 


3. Another HP 3000 Computer System that is also being 
controlled by an HP 2780/3780 Emulator. 


Some of the examples show job (batch) mode usage and 
others show session usage. Each example is thoroughly 
annotated so you can easily follow what is happening. 


Note: In the examples that communicate with a 
remote job processing system, the remote 
system is assumed to be similar to IBM 
HASP/360. For example, it is assumed 


that: 


1. You do not have to transmit a 
terminal ID when establishing the 
communications link; 


2. You must transmit a ‘‘log-on’”’ card 
image immediately followed by an 
EOT control character after the com- 
munications link has been esta- 
blished and before any other input/ 
output activity is performed; and 


3. You must transmit a “‘log-off’’ card 
image just before terminating the 
communications link. 


By making minor alterations to the com- 
mand sequences, you can adapt these 
examples to communicate with most any 
remote job processing system. 


In the example that communicates with 
an IBM 2780, you can adapt the example 
to communicate with an IBM 3780 or 
another similar communications termi- 
nal by making minor alterations to the 
#RJLINE and #RJIN commands. 
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The scope of each example is as follows: 


Example 1 


A batch job that communicates with a remote job process- 
ing system over the public telephone network. The job 
transmits one input data set to the remote processor and 
receives one list output data set in return. 


Example 2 


Two interactive sessions that communicate with a remote 
job processing system over the public telephone network. 
The first session transmits one input. data set to the remote 
processor and then terminates. The second session receives 
the list output data set generated as a result of the first 
session’s input being processed. 


Example 3 


A batch job that communicates with a remote location over 
a private leased line. Data is received from a remote termi- 
nal or system, processed in a user output procedure and a 
result data set returned. 


Example 4 


A batch job that communicates with a remote job process- 
ing system over the public telephone network. The job deck 
is a combination of card decks supplied by several users and 
the computer operator. The job transmits three input data 
sets to the remote processor and receives three list output 
data sets and one punched output data set in return. 


Example 5 


An interactive session that communicates with an IBM 
2780 Data Transmission Terminal. The Emulator command 
sequence is permanently stored in a file on disc and is exe- 
cuted periodically by the computer operator by means ofa 
three-ccommand MPE session. The Emulator command Sse- 
quence receives a variable number of punched output data 
sets that, when received, are stored in a disc file. 


Example 6 


An interactive session that transfers a file from one HP 
3000 Computer System to another. The command se- 
quence for both computer systems is shown in parallel. 


Example 7 


An interactive session that communicates with an IBM host 
which supports HASP, emulating a 3780 Data Transmission 
Terminal. A FORTRAN program, stored in an HP 3000 
disc file, is sent to the host where it executes to generate 
output for one standard and two special forms. 
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4-1. EXAMPLE 1: RJE BATCH JOB (ONE INPUT DATA SET, IMMEDIATE OUTPUT) 





This example shows you how to put together a complete, self-contained remote job entry (RJE) batch job which a computer 
operator could then run on your HP 3000 Computer System without adding anything to the job. The entire job is in the 
form of a punched card deck. It contains one input data set. One list output data set is expected as a result of the input 
being processed. 


The example is based on the following assumptions: 

Mode of Operation: Batch job. 

Device Emulated: IBM 2780. 

Remote Processor: A remote job processing system that requires a /*$LOGON card immediately 
followed by an EOT control character at the beginning of the run and a /*$LOGOFF 


card at the end of the run. 


Communications Link: Public telephone network. The computer operator of your HP 3000 Computer System 
must manually make the telephone connection with the remote processor. 


Transmission Code: EBCDIC. 


Input Code: ASCII. The Emulator automatically converts the input data from ASCII to EBCDIC 
at transmission time. 


Command File: Card reader (SSTDINX, the standard job input device). 
Input File: Card reader (SSTDINX, the standard job input device). 
List File: Line printer (SSTDLIST, the standard job listing device). 


Punch File: Not used. 


The job deck is as follows: 


:JOB username.acctname 
1) :-RJIE 
© #RJLINE 2780;LINECODE=EBCDIC;CONNECT=DIAL, “409-247-7000” 


#RJIN ; TRUNCATE=NO 
© [*SIGNON REMOTE37 


4 #RJEOD 
G #RJIN 
Data Set 
#RJOUT ;WAIT=10 


rT #RJIN ; TRUNCATE=NO 
/*SIGNOFF 


@ mu 


“EOD 
:EOJ 
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The annotations for the job deck are as follows: 


This command invokes the Emulator and defines the 
four Emulator files by default as follows: 





Command File: $STDINX 

Input File: $STDINX 

List File: $STDLIST 

Punch File: $OLDPASS (if it exists) or 
$NEWPASS (if $OLDPASS does 
not exist) 


© This command states that an IBM 2780 is to be emu- 
lated, the transmission code is to be EBCDIC, the 
communications link is to be established by your 
computer operator manually dialing the remote pro- 
cessor (409-247-7000) via a MODEM, the maximum 
number of records per trdnsmission block is to be 7 
(non-transparent mode) or 4 (transparent mode), no 
terminal ID is to be transmitted, and no RIN is to be 
used, 





This pair of cards specifies that an 80-column card 
image is to be transmitted to the remote processor. 
The /*SIGNON card satisfies the log-on requirements 
of the host computer. 





© This command completes transmission of the above 
#RJIN sequence, then sends an EOT control charac- 
ter to the remote processor. The Emulator now issues 
a dial message to the operator’s console. In response, 
the computer operator dials 409-247-7000 on the 
MODEM and then enters YES or NO through the 
operator’s console to let the Emulator know whether 
or not the remote processor answered. 
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oO This command transmits one input data set to the 


remote processor. The input data set immediately 
follows the #RJIN command in the job deck. The 
#RJIN command states that the entire input data set 
is to be transmitted, no data compression is to be 
performed, the non-transparent mode is to be used, 
short-record truncation is to be performed, and the 
input data set is in ASCII format. The Emulator will 
automatically convert the input to EBCDIC at trans- 
mission time. 


This command transmits an EOT control character to 
the remote processor, thus completing the transmis- 
sion initiated by the preceding #RJIN command, and 
then causes the Emulator to turn the line around and 
wait for output from the remote processor. One out- 
put data set will be processed. When received, it will 
be passed to the file named $STDLIST (the standard 
job listing device). If transmission of the expected 
output does not begin within 10 minutes, the 
Emulator will terminate the #RJOUT command and 
read the next Emulator command. 


This pair of cards transmits an 80-column card image 
to the remote processor. The /*SIGNOFF card termi- 
nates the RJE session. 


This command transmits an EOT control character to 
the remote processor, thus completing the transmis- 
sion initiated by the preceding #RJIN command, 
terminates the HP 2780/3780 Emulator subsystem, 
and performs a line disconnect operation. 
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4-2, EXAMPLE 2: RJE SESSION (ONE INPUT DATA SET, DEFERRED OUTPUT) 


This example shows you how to transmit a remote job entry (RJE) input data set to a remote processor by means of a 
session and then retrieve the associated output by means of a subsequent session. In the first session, the Emulator 
commands are entered through an interactive terminal and the input data set is read from a disc file. In the second session, 
the Emulator commands are again entered through an interactive terminal while the output data set is passed to a line 
printer. 






The example is based on the following assumptions: 






Mode of Operation; Interactive session. 






Device Emulated: IBM 2780. 





Remote Processor: A remote job processing system that requires a /*$LOGON card immediately 
followed by an EOT control character at the beginning of the run and a /*$LOGOFF 
card at the end of the run. 








Communications Link: Public telephone network. The computer operator of your HP 3000 Computer System 
must manually make the telephone connection with the remote processor. 









EBCDIC. 


Transmission Code: 








Input Code: ASCII. The Emulator automatically converts the input data from ASCII to EBCDIC 


at transmission time. 











Command File: 





Interactive terminal ($STDINX, the terminal through which the session was 
initiated). 






Input File: $STDINX for /*SIGNON and /*SIGNOFF card images and disc file (INFIL) for 
input data set. 









List File: Line printer (logical device number 6). 








Punch File: 






Not used. 





The first session is as follows: 






The second session is as follows: 












:HELLO username.acctname 


@ :-RJE 


#RJLINE 2780; LINECODE=EBCDIC 
;CONNECT=DIAL, “247-7000” 


:-HELLO username.acctname 
‘RIE 


#RJLINE 2780; LINECODE=EBCDIC 
;CONNECT=DIAL,‘‘247-7000” 














/*SIGNON REMOTE72 password 


4) #RJEOD 
5 #RJIN INFIL 


/*SIGNON REMOTET2 password 
© #RJOUT 6;WAIT=5 
— -TRUNCATE=NO 


3 | #RJIN :s TRUNCATE=NO | #RJIN ; TRUNCATE=NO 







/*SIGNOFF 







#RJEOD 
#RJIN ; TRUNCATE=NO #RJEND 

oO) /*SIGNOFF ‘BYE 
#RJEND 


-BYE 
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The annotations for the above sessions are as follows: 


Note: Annotations 1, 2, 3, 7, and 8 for the first 
session also apply to the corresponding 
commands in the second session. 


This command invokes the Emulator and defines the 
four Emulator files by default as follows: 


$STDINX (the interactive termi- 
nal through which the session 
was initiated) 


Command File: 


Input File: $STDINX 

List File: $STDLIST (the interactive termi- 
nal through which the session 
was initiated) 

Punch File: $OLDPASS (if it exists) or 


S$NEWPASS (if $OLDPASS does 
not exist) 


@ This command states that an IBM 2780 is to be emu- 
lated, the transmission code is to be EBCDIC, the 
communications link is to be established by your 
computer operator manually dialing the remote pro- 
cessor (247-7000) via a MODEM, the maximum 
number of records per transmission block is to be 7 
(non-transparent mode) or 4 (transparent mode), no 
terminal ID is to be transmitted, and no RIN is to be 
used. 


© This pair of entries specifies an 80-column card image 
is to be transmitted to the remote processor. The 
/*SIGNON card satisfies the log-on requirements of 
the host system. 


4) This command completes transmission of the above 
#RJIN sequence, then sends an EOT control charac- 
ter to the remote processor. The Emulator now issues 
a dial message to the operator’s console. In response, 
the computer operator dials 247-7000 on the 
MODEM and then enters YES or NO through the 
operator’s console to let the Emulator know whether 
or not the remote processor answered. 


Note: Since the Command File and the Input 
File are the same and the Emulator is 
currently in the input mode, the # 
prompt character is not issued by the 
Emulator and must be entered by the 
user as part of the RJEOD command. 
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5) This command transmits one input data set to the 
remote processor. The input data set is read from the 
disc file INFIL. The #RJIN command states that the 
entire input data set is to be transmitted, no data 
compression is to be performed, the non-transparent 
mode is to be used, short-record truncation is to be 
performed, and the input data set is in ASCII format. 
The Emulator will automatically convert the input to 
EBCDIC at transmission time. 


This command transmits an EOT control character to 
the remote processor, thus completing the transmis- 
sion initiated by the preceding #RJIN command. 





Oo This pair of entries transmits an 80-column card 
image to the remote processor. The /*SIGNOFF card 
terminates the RJE session. 


This command transmits an EOT control character to 
the remote processor, thus completing the transmis- 
sion initiated by the preceding #RJIN command, 
terminates the HP 2780/3780 Emulator subsystem, 
and performs a line disconnect operation. 





Note: Since the Command File and the Input 
File are the same and the Emulator is 
currently in the input mode, the # 
prompt character is not issued by the 
Emulator and must be entered by the 
user as part of the RJEND command. 


© This command completes transmission of the above 
#RJIN sequence, sends an EOT control character to 
the remote processor, and causes the Emulator to 
turn the line around and wait for output from the 
remote processor. One output data set will be proces- 
sed. When received, it will be passed to logical device 
6 (assumed to be a line printer in this example). If 
transmission of the expected output does not begin 
within 5 minutes, the Emulator will terminate the 
#RJOUT command and prompt you for the next 
command. 


Note: Since the Command File and the Input 
File are the same and the Emulator is 
currently in the input mode, the # 
prompt character is not issued by the 
Emulator and must be entered by the 
user as part of the RJOUT command. 
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4-3. EXAMPLE 3: RJE BATCH JOB (PUNCH OUTPUT TO A USER PROCEDURE) 


This example shows you how to receive data, process it in a user-written procedure and return result data. 





The example is based on the following assumptions: 









Mode of Operation: Batch job. 








Device Emulated: IBM 3780. 





Remote Processor: A remote job processing system that requires a /*SIGNON card immediately followed 
by an EOT control character at the start of the run and a /*SIGNOFF card at the end 
of the run. 















Communications Link: Private leased line. The communications link is automatically established when an 


#RJLINE command is processed. 









Transmission Code: ASCII. 









Input Code: Binary. 





Command File: Card reader ($STDINX), the standard job input device. 






Input File: RTNDATA 





List File: Line printer ($STDLIST, the standard job listing device). 






Punch File: 





User-supplied procedure PUNCHPROC in the user’s Group Library. 





The job deck is as follows: 










JOB username.acctname 


@ 2x 


2 #RJLINE 3780;LINECODE= ASCH 











© #RJPUNCH @PUNCHPROC(G);OUTCODE=BINARY;OUTSIZE= 128;WAIT= 180 





4) #RJIN RTNDATA;XPARENT= YES; INCODE=BINARY;MAXSIZE= 128 
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The annotations for the job deck are as follows: © This command states that there will be a waiting 











This command invokes the Emulator and defines the 
four Emulator files by default as follows: 


Command File: $STDINX 

Input File: $STDINX 

List File: $STDLIST 

Punch File: SOLDPASS (if it exists) or 


$NEWPASS (if $OLDPASS does 
not exist) 


This command states that an IBM 3780 is to be 
Emulated, the transmission code is ASCII, the 
maximum number of records per transmission block 
is to be 255 (non-transparent mode) or 6 (transparent 
mode), no terminal ID is to be transmitted and no 
RIN is to be used. Since the communications link is a 
private leased line, the connection with the remote 
processor is established automatically when the 
#RJLINE command is executed. 
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period of up to three hours to receive one output data 
set, received data will be processed by the 
user-supplied procedure PUNCHPROC, no code 
conversion will be performed by the Emulator, 
output record size will be either the received record 
size, if the data is non-transparent, or 128 words, if 
the data is transparent. See Appendix G for an 
example of a user output procedure. 


4 This command transmits the contents of the file 


RTNDATA in transparent mode, no data 
compression, truncation or code conversion will be 
performed, and the input record size will be the 
record size of the file RTNDATA or 128 words, 
whichever is less. This file might have been created 
and written by the user procedure, based upon 
received data. 


This command transmits an EOT control character to 
the remote processor, thus completing the 
transmission indicated by the preceding #RJIN 
command, terminates the HP 2780/3780 Emulator 
subsystem, and performs a line disconnect operation. 
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4-4, EXAMPLE 4: RJE BATCH JOB (MULTIPLE USER INPUT, IMMEDIATE OUTPUT) 





This example shows how you, other users, and a computer operator can together build a complete remote job entry (RJE) 
batch job which transmits your input and the other users’ input to a remote processor and retrieves the output 
immediately. The entire job is in the form of a punched card deck. It contains three input data sets. Three list output data 
sets and one punched output data set are expected as a result of the input being processed. 


The example is based on the following assumptions: 

Mode of Operation: Batch job. 

Device Emulated: IBM 2780. 

Remote Processor: A remote job processing system that requires a /*SIGNON card immediately fol- 
lowed by an EOT control character at the start of the run and a /(SIGNOFF card 


at the end of the run. 


Communications Link: Public telephone network. The computer operator of your HP 3000 Computer System 
must manually make the telephone connection with the remote processor. 


Transmission Code: ASCII, 

Input Code: ASCII. 

Command File: Card reader (SSTDINX, the standard job input device). 
Input File: Card reader (SSTDINX, the standard job input device). 
List File: Line printer (SSTDLIST, the standard job listing device). 


Punch File: Any card punch in the system (in this example CP is assumed to be the device class 
name for all card punches in the system). 


The job deck is as follows: 


:JOB username.acctname 
@ .FILE PNCH;DEV=cP 
. * 
2] iRJE ,,,*PNCH Supplied by the 
® A#ARJLINE 2780;CONNECT=DIAL,"'247-7000": LINECODE=ASCII computer operator to 


the batch deck. 
ri ARJIN :TRUNCATE=NO 
/*SIGNON REMOTE18 





Supplied by user ‘‘A."’ 


Supplied by user “B.” 
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@ #RJOUT .99:WAIT=5 


o; 


#RJIN ;TRUNCATE=NO 
/*SIGNOFF 


@ #RJEND 
-ECD 


The annotations for the job deck are as follows: 


This command equates the device class name CP to 
the formal file designator PNCH. 





This comand invokes the Emulator and defines the 
four Emulator files as follows: 


SSTDINX (the standard job 
input device). 


Command File: 


Input File: $STDINX. 

List File: $STDLIST (the standard job 
listing device). 

Punch File: Any card punch in the system. 





@ mis command states that an IBM 2780 is to be 
emulated, the transmission code is to be ASCII, the 
communications link is to be established by your 
computer operator manually dialing the remote 
processor (247-7000) via a MODEM, the maximum 
number of records per transmission block is to be 7 
(non-transparent mode) or 2 (transparent mode), no 
terminal ID is to be transmitted, and no RIN is to be 
used. 





© This pair of cards transmits an 80-column card image 
to the remote processor. The /*SIGNON card satis- 
fies the log-on requirements of the host system. 


This card transmits an EOT control character to the 
remote processor, thus completing the transmission 
initiated by the preceding #RJIN command. 


This command transmits the first input data set to 
the remote processor. The input data set immediately 
follows the #4RJIN command in the job deck. The 
#RJIN command states that the entire input data set 
is to be transmitted, no data compression is to be 
performed, the non-transparent mode is to be used, 
short-record truncation is to be performed, and the 
input data set is in ASCII format. 





This command transmits an EOT control character to 
the remote processor, thus completing the trans- 
mission initiated by the preceding 4RJIN command. 
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Supplied by the computer operator 
to the batch deck. 





This command transmits the second input data set to 
the remote processor. The input data set immediately 
follows the 4RJIN command in the job deck. The 
#RJIN command states that the entire input data set 
is to be transmitted, no data compression is to be 
performed, the non-transparent mode is to be used, 
short-record truncation is to be performed, and the 
input data set is in ASCII format. 


This command transmits an EOT control character to 
the remote processor, thus completing the trans- 
mission initiated by the preceding #RJIN command. 





This command transmits the third input data set to 
the remote processor. The input data set immediately 
follows the #4RJIN command in the job deck. The 
#RJIN command states that the entire input data set 
is to be transmitted, no data compression is to be 
performed, the non-transparent mode is to be used, 
short-record truncation is to be performed, and the 
input data set is in ASCII format. 





This command transmits an EOT control character to 
the remote processor, thus completing the trans- 
mission initiated by the preceding 4RJIN command. 





This command causes the Emulator to turn the line 
around and wait for output from the remote 
processor. The #RJOUT command states that 99 
output data sets are expected. This number was 
chosen as a convenience so that the same #4RJOUT 
card could be used in many different runs without 
having to be altered. The 4RJOUT command will be 
terminated by the Emulator whenever 5 minutes 
elapses without anything being received from the 
remote processor. 








This pair of cards transmits an 80-column card image 
to the remote processor. The /*SIGNOFF card termi- 
nates the RJE session. 


This command transmits an EOT control character to 
the remote processor, thus completing the trans- 
mission initiated by the preceding #RJIN command, 
terminates the HP 2780/3780 Emulator subsystem, 
and performs a line disconnect operation. 
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4-5. EXAMPLE 5: SESSION EXECUTING A DISC-RESIDENT EMULATOR COMMAND SEQUENCE 


This example shows you how to execute a disc-resident Emulator command sequence by means of a three-command MPE 
session. Such a situation arises when a commonly-used Emulator command sequence must be executed on a regular basis. 


The case shown in this example involves an installation that must, several times a day, establish a connection with a remote 
IBM 2780, accept a variable number of punched output data sets, and then terminate the connection. 


This example is based on the following assumptions: 


Mode of Operation: 
Device Emulated: 


Remote Processor: 


Communications Link: 


Transmission Code: 
Output Code: 
Command File: 
Input File: 

List File: 


Punch File: 


Interactive session. 

IBM 2780. 

An IBM 2780 which transmits order processing information in the form of 80- 
character records, one record per order. The orders are grouped into data sets, 


one data set per product line. 


Public telephone network. The operator of your HP 3000 Computer System must 
manually make the telephone connection with the remote processor. 


ASCII. 

ASCII. 

A disc file named RJCMND. 

Not used. 

$STDLIST (the interactive terminal through which the session is initiated). 


A disc file named ORDFIL. 


Assume that the following Emulator command sequence is stored in the disc file named RJCMND: 


@ #RJLINE 2780;CONNECT= DIAL,“247-7000”;LINECODE= ASCII 


2 #RJPUNCH ,99;WAIT= 10 


3 #RJEND 


When the Emulator command sequence is to be executed, the computer operator executes the following 
MPE commands through an interactive terminal: 


4) -HELLO username.acctname 


-RJE RJCMND,,, ORDFIL 


‘BYE 
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The annotations for the example are as follows: 


@ This command states that an IBM 2780 is to be 
emulated, the transmission code is ASCII, the 
communications link is to be established by the 
computer operator manually dialing the remote 
processor (247-7000) via a MODEM, the maximum 
number or records per transmission block is 7 
(non-transparent mode) or 2 (transparent mode), no 
terminal ID is to be transmitted and no RIN is to be 
used. 


2 The Emulator now issues a dial message to the 
operator’s console. The computer operator dials 
247-7000 on the MODEM and then enters YES or NO 
through the operator’s console to let the Emulator 
know whether or not the remote processor answered. 
The Emulator will now wait for output from the 
remote processor. The #RJPUNCH command states 
that 99 unrouted punched output data sets are 
expected. This number was chosen so that the 
Emulator command sequence could be used 
repeatedly without the #RJPUNCH command 
having to be altered. The #RJPUNCH command is 
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terminated automatically by the Emulator whenever 
10 minutes elapse without anything being received 
from the remote processor. When received, the output 
data sets will be passed to the disc file named 
ORDFIL. 


© This command transmits an EOT control character to 


the remote processor, thus completing the 
transmission initiated by the preceding #RJIN 
command, terminates the HP 2780/3780 Emulator 
subsystem, and performs a line disconnect operation. 


This command invokes the Emulator and defines the 
four Emulator files as follows: 


Command File: A disc file named RJCMND. 

Input File: Not used. 

List File: $STDLIST (the interactive ter- 
minal through which the session 
is initiated). 


Punch File: A disc file named ORDFIL. 
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4-6. EXAMPLE 6: HP 3000 TO HP 3000 FILE TRANSFER 


This example shows you how to pass a file from one HP 3000 Computer System to another using the Emulator. The Emulator 
command sequence for both computer systems is shown in parallel. Since the receiving system (System B in this example) 
must start executing Emulator commands before the telephone connection is established, the overall operation must be 
coordinated either by a schedule or by verbal communication between the operators of the two computer systems. In this 
example it is assumed that the file transfer takes place at 4:00 PM everyday. 





The example is based on the following assumptions: 


SYSTEM A SYSTEM B 

Mode of Operation: Interactive session. Interactive session. 

Device Emulated: IBM 3780 IBM 3780 

Communications Link: Public telephone network. The com- Public telephone network. The telephone 
puter operator must manually make connection is automatically established 
the telephone connection with System when an incoming call is detected by the 
B via a MODEM. MODEM after the #RJLINE command 

has been executed. 

Transmission Code: ASCII. ASCII. 

Input Code: ASCII. Not applicable. 

Output Code: Not applicable. ASCII. 

Command File: $STDINX (the interactive terminal $STDINX (the interactive terminal 
through which the session was initi- through which the session was initi- 
ated). ated). 

Input File: A disc file named XFILE. Not applicable. 


Punch File: Not applicable. A disc file named HPFILE. 


The command sequences are as follows: 
SYSTEM A SYSTEM B 
sHELLO username.acctname 
-RJE 


#RJLINE 3780;CONNECT= ANSWER 
; LINECODE= ASCII 


@ #RJPUNCH HPFILE;OUTSIZE= 128 


4:00 PM:HELLO username.acctname 
‘-RJE 


& #RJLINE 3780;CONNECT= DIAL,“123-4567” 
;sLINECODE= ASCII 


4) #RJIN XFILE;XPARENT= Y;MAXSIZE= 128 


@ #RJEND @ -renp 


BYE ‘BYE 
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The annotations for the command sequences are as 
follows: 


This command states that an IBM 3780 is to be 
Emulated, the transmission code is to be ASCII, the 
MODEM is to start monitoring the line for an 
incoming call, no terminal ID is to be transmitted and 
no RIN is to be used. 


Qa: soon as the communications link has been 


established, this command causes the Emulator to 
accept an output data set from System A. When 
received, the output data set will be passed to the file 
named HPFILE on disc. Since the received data is 
transparent, it will be processed as 128-word records 
rather than 80-byte records as would be the case if the 
OUTSIZE parameter were not specified. At this point 
in the run the Emulator merely waits (pauses) until 
the communications link is established and data 
transmission is begun. 


This command states that an IBM 3780 is to be 
emulated, the transmission code is to be ASCII, the 
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communications link is to be established by the 
computer operator manually dialing System B 
(123-4567) via a MODEM, no terminal ID is to be 
transmitted and no RIN is to be used. 


This command transmits one input data set to 
System B. The input data set is read from the file 
named XFILE on disc. The #RJIN command states 
that the entire input data set is to be transmitted, no 
data compression is to be performed, the transparent 
mode is to be used, short record truncation is not to be 
performed, the input data set is in ASCII format and 
the maximum input record size is 128 words. 


This command transmits an EOT control character to 
System B, thus completing the transmission 
initiated by the preceding #RJIN command, and 
then terminates the HP 2780/3780 Emulator. 


This command transmits an EOT control character to 
the remote processor, thus completing the 
transmission initiated by the preceding #RJIN 
command, terminates the HP 2780/3780 Emulator 
subsystem, and performs a line disconnect operation. 
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4-7. EXAMPLE 7: A FORTRAN JOB SENDS OUTPUT TO MULTIPLE FORMS 


At times, persons using the RJE Emulator would like to vary the forms for the output of different data sets. This example 
sends output to one standard and two special forms from the FORTRAN program shown in Figure 4-1. It illustrates the com- 
mands submitted at the terminal, the prompts printed on the system console, the dialing procedure, and the replies required 
of the console operator in order to retrieve the output. 


The example uses the standard device “Operator-controlled Mode” that is supported by HASP. For more information about 
this mode, refer to pages 45 through 49 of the OS/VS2, HASP II Version 2, Operator’s Guide (IBM part number GC27-6993-0). 
On the HP 3000, the example uses the normal spooling capabilities to the line printer. 






The example is based on the following assumptions: 






Mode of Operation: Interactive session. 





1BM 3780. 






Device Emulated: 






Remote Processor: IBM host computer supporting HASP. 






Communications Link: Half-duplex modem operating with a dial network. 






Transmission Code: EBCDIC. 






Input Code: ASCII. 






Command File: Interactive session terminal. 






Input File: IBMF3. 






List File: Line printer (logical device 6). 







Punch File: Not used. 






Legend of Terminal and Console Prompts: 





MPE prompt for input from a user 








= Emulator prompt for input from a user 

{* IBM job control command 

/*$ HASP subsystem command NOTE: In the following dialogue, 

$ HASP response to a user al] input to the system is underlined. 






= Console operator prompt for MPE attention (control-A) 






MPE prompt to the console operator for a reply 








:HELLO username.acctname 







‘PILE LP;DEV=LP 





:<RIE 
HP30130C.00.02 RJE/3000 (CS A.00.06) 
WED, APR 20, 1977, 7:19 PM 







#RILINE 3780;DEV= 14 ;LINECODE=EBCDIC;CONNECT= DIAL, 123-4567 





#RIJIN 


FSIGNON REMOTE30 
RJEOD 


er S 









@ (at the console) 
2§T/19:32/28/LDEV#14 DIAL 123-4567. ANSWER? (Y/N) 
=REPLY 28,Y 










#RJIN IBME3 
#RJEOD 









#RIJOUT;WAIT=2 
$19.33.04 JOB 116 ON RM30.RD1 — GSDX2769 BRAWN 
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ce #/*SDI116 
$19.39.00 JOB 116 GSDX2769 EXECUTING G PRIO 4 
#/*$DE 
$19.50.19 OUT 30 F=C333 C=6 T=**** CLS C= 1 
$19.50.19 OUT 30 F=C777 C=6 T=**** CLS C= 1 
$19.50.19 OUT 30 F=STD. C=6 T=**** CLS A=2 


#/*$T RM30.PR1,F=C333,Q=C 
$20.09.22 OK 





eo OO 


#RILIST *LP;FORMSMSG=C345 


® (at the console) 
10/20:11/14/FORMS: C345 
210/20:11/14/SP#6/ IS #S8101;LP ON LDEV#6? (Y/N) 
=REPLY 14,Y 
210/20:16/14/LDEV#6 FORMS ALIGNED OK? (Y/N) 
=REPLY 14,Y 


#/*ST_RM30.PRLE=STD.,Q=A 
$20.11.04 OK 





#RILIST *LP:WAIT=2 


(at the console) 

@® 210/20:17/14/SP#6/ IS #S101;LP ON LDEV#6 (Y/N) 
=REPLY 14,N 
ST/20:18/SP#6/#0195 DEFERRED 


#/*ST RM30.PR1,F=C777,Q=C 
$20.12.23 OK 





eo 6°90 


#RILIST *LP;FORMSMSG=C778 


_ @ (at the console) 


10/20:18/14/FORMS: C778 
210/20:18/14/SP#6/ IS #S101;LP ON LDEV#6 (Y/N) 


=REPLY 14,Y 
210/20:23/14/LDEV #S6 FORMS ALIGNED OK? (Y/N) 
=REPLY 14,Y 

#/*SIGNOFF 

#RJEND 

END OF SUBSYSTEM 


- : ‘BYE 
z (at the console) 
=ALTFILE #0195;OUTPRI=2 
10/20:26/14/STANDARD FORMS , 
2 10/20:26/14/SP#6/ IS #S5101;LP ON LDEV#6 (Y/N) 





=REPLY 14,Y 
The annotations for the terminal session and console The #RJIN command provides the signon sequence 
activity follow: for the host computer. The #RJEOD command com- 
pletes the buffer and signals the Emulator to prompt 
This file definition for the line printer will be used the console operator with the phone dial message. 


from the Emulator subsystem for #RJLIST output. 
The dial message is printed on the system console. 





This command invokes the Emulator and defines the Before responding, the operator places the call, re- 

Emulator files by default. ceives the carrier tone, and presses the DATA button. 
Then he types YES, thus completing the dialing 

This command states that the IBM 3780 is to be emu- sequence. 

lated. It assigns logical device 14 to the communica- 

tions line and specifies EBCDIC as the linecode. The This command transmits the FORTRAN program to 

console operator will be prompted to dial 123-4567 the remote processor from an HP 3000 disc file named 

at the appropriate time. IBMF3. The input is in ASCII format but the Emu- 
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lator automatically converts it to EBCDIC for trans- 
mission. 


The program uses the FORTGCLG IBM subsystem. 
It also uses the standard JCL provided by the host ex- 
cept that logical devices 3 and 7 are respecified for 
special forms. The STP3 file equations, shown in the 
program listing in Figure 4-1, replace the standard 
JCL. However, because the JCL provided by the host 
is installation dependent, the STP3 file equations may 
differ for each IBM host system. 


The #RJOUT allows the HASP system to transmit 
the number it has assigned to this job, J116 on the 
host system. At this point, the job has been sub- 
mitted through the HASP subsystem, it has been 
spooled on the host input spooling device, the JCL 
library procedure has been added to the job, and the 
standard JCL definitions for devices 3 and 7 have 
been replaced by the //STP3 file equations in the 
FORTRAN program. 


This command requests the status of J116. The host 
response indicates the job is active, awaiting execu- 
tion. This means that all the required system resources 
are available for its execution and that the JCL is 
satisfactory. The job is queued by priority to await 
CPU execution. 


This command requests that the host system display 
the status of files associated with the job. The re- 
sponse indicates the job has executed, its output has 
been spooled, and the data sets are now available to 
HASP for output to the physical device. The response 
shows that output is assigned to the special forms 
specified in the FORTRAN STP3 file equations, as 
well as to the standard printer output device (device 6). 


This command configures the HASP printer for spe- 
cial form, C333. HASP can now transmit any pending 
data sets that require this special form (in this case, 
one data set). 


This command signals HASP to transmit the first data 
set. It also specifies a FORMSMSG for the HP 3000 
spooler. The form assigned on the HP 3000, C345, is 
independent of the form designated on the IBM host. 
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At this point the first data set has been transferred to 
a 3000 spool file. The first message to the system con- 
sole states which form is required for the output. It 
is followed by a prompt asking if the form is available. 
The second prompt asks whether the form is properly 
aligned on the line printer. After the system operator 
responds Y to the questions, the output is printed in 
the format: HASP banner, output data, HASP banner. 
Note that the actual printing of spooled output is 
handled by the MPE Spooler subsystem, not by the 
Emulator. The two are independent. 


This command reconfigures the HASP printer for 
standard output file(s). 


This command signals HASP to transmit the second 
data set. 


The second data set has been transferred to a 3000 
spool file. However, in this case, the operator defers 
printing until a later time by responding No to the 
request for output device assignment. This changes 
the priority of the spool file to 0. 


This command configures the HASP printer for spe- 
cial form, C777. Now HASP can transmit any data 
sets that require this form (in this case, one data set). 


This command signals HASP to transmit the third 
data set. It also specifies a FORMSMSG for the HP 
3000 spooler. The form assigned on the HP 3000, 
C778, is independent of the form designated on the 
IBM host. 


At this point, the third, and last, data set has been 
transferred to a 3000 spool file. The 3000 system 
prompts the console operator for the special form, 
C778, and asks whether it is aligned on the line 
printer. After the operator responds Y, the output is 
printed. 


Finally, in order to retrieve the output destined for 
the standard form (the output that was deferred ear- 
lier), the console operator alters the file’s priority and 
replies to the subsequent prompt for device assign- 
ment. 

















30130C 


//43SD%2769 JOB 
//* MEL BRAWN, BLDG 53, 


1 / 


Programming and Operating Examples 


"6468 474499", "BNAWN', CLASS=R 
ExT 2767 
EXEC FORTGCLG 


//STPLe¢SYSIN DD * 


C 


CG OUTPUT TO “THE. Pile sT Form 


C 


59 
IAA 
C 


DO SA I=155 
WRITE €6,9%A) I,I15,I1.,] 
FORMAT C2I18S19%s 'OMTOIIT TO FIRST FOPM',14%,21%) 


DO 144 1=135 

DO 14% JSliilibstitiii%5,119t01 

K=Jelilid) 

WOUTE €621AA%) Ks Ka Ks Ko Ks Ko ha Ka Ka Ko Ka Ka Ko Ka Ke Ko Ka Ka Ka K 
FOPMAT CI1Hs 2416) 


DO 154% I=155 
WOITE €6,9@%)Is1,121 


C OUTPUT TO A SECOND FORM 


DO P4A T=155 
WOITE C7s,14A1IA%I Iso I,I151 
FOP MAT CEIB8s LAX, POMTOIT TO FOCM NIMRET TVO's LAKs O18) 


DO 348% 1=1519%% 
WeITe C#7s,1924)TesTststIs Is IsIsIs,Isl1 
FOPMAT C143I114) 


DO 44% 1=155 
WeLTeE C721 G1) 


G OuTeur TO AO THIRD: FOR 


C 


54S 


144A 


62 


TAD 


/* 


S/STP3eFTASFAGR 1 


// 


//STOPZeFTATEAG! 


// 
// 


DO S@A@ r=155 
WOITE C3s1A4GADTsIsIsI 
FORMAT C2I1R,19™, *OITSUT TO THISD FORM',14%5,2°018%) 


DO 699 JT=15149 
WRITE C3,1A3Q@)IeteslstlslIstIsts Isis l 


DO 799A T=f55 
VRITE C3, 14946) Is, I151 


STOP 
END 


DD SYSOMTHCCs5C333)>5 
DCPR=(TECFM=UA., BLK SIZE=133,LPECL=1 33) 
DD SYSOUT=(€Cs5C777)> 
DCB=C(CRECFM=UAs BLKSIZE=133,LRECL=133) 


These STP3 file equations specify 
special forms C333 and C777. 


Figure 4-1. A Sample FORTRAN Program That Uses Multiple Forms 
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The HP 2780/3780 Emulator issues two types of messages: 
e Informational messages. 
e Error messages. 


The informational messages are those which are normally 
issued at the start and end of an Emulator job or session (for 
example, END OF SUBSYSTEM). The error messages are 
issued only when something goes wrong (for example, **** 
LIST FILE ERROR: 2,34). 


The Emulator displays the messages either on the job list- 
ing device (batch job) or on your terminal (interactive 
session). 


This section presents all of the messages and describes 
their formats, their probable causes, and what you should 
do in response to them. 


5.1 START MESSAGE 
When an :RJE command is executed, the Emulator issues 
the following message: | 


HP30130x.yy.zz(CSx.yy.zz)RJE/3000 date, time 
where 


xX 


is an alphabetic character specifying what versions of the 
HP 2780/3780 Emulator and CS are being used. 


YY 
is a pair of digits specifying the version’s update level. 


2Z 
is a pair of digits specifying the version’s fix level. 


date 

is an alphanumeric character string specifying the day of 
the week and the date of the particular job/session (for 
example: THU, MAY 27, 1976). 


time 

is an alphanumeric character string specifying the 
starting time of the particular job/session (for example: 
7:45 AM). 


After the start message is issued, the Emulator reads the 
first Emulator command (batch job) or displays a # on your 
terminal to prompt you for the first Emulator command 
(interactive session). 
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5-2. FILE SYSTEM ERRORS 

Messages issued as the result of file system errors indicate 
that the Emulator could not open, close, read from, or write 
into a file using the MPE File System. A file system error 
always causes a batch job to terminate. In an interactive 
session, after issuing the error message the Emulator 
displays a # on your terminal to prompt you for the next 
Emulator command. 


5-3. ERROR MESSAGES 


The formats of the file system error messages are as 
follows: 


*e** COMMAND FILE ERROR: x,yy 


2K KR 


INPUT FILE ERROR: x,yy 


KK 


LIST FILE ERROR: x,yy 


38K 2 


PUNCH FILE ERROR: x,yy 


aK ok 


OUT FILE ERROR: x,yy 
*e** SOURCE FILE ERROR: x,yy 
where 


x 
is a digit specifying the type of error, as follows: 


0 = FOPEN error (file could not be opened) 
1 = FCLOSE error (file could not be closed) 


2 = FREAD or FWRITE error (file could not be read 
from or written into) 


3 = ran out of file space 


yy 
is a two-digit error code returned by the MPE FCHECK 
procedure. 


5-4. PROBABLE CAUSES 
Error codes 0, 1, and 2 are caused by a variety of conditions, 
of which some typical examples are: 


e The specified file (or the device containing the file) is 
currently being used by someone else or is not connected 
on-line to the computer. 
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e You violated the security restrictions associated with 
the file. 


e You accidentally specified the name of a non-existent 
file. 


Error code 3 is associated only with the LIST, PUNCH, and 
OUT files. It indicates that the specified file was not large 
enough to accommodate all of the output data set. 


5-5. RECOVERY PROCEDURES 


For error codes 0, 1, and 2, look up the two-digit error code 
(yy) in the table of error codes presented in connection with 
the FCHECK procedure in the MPE Intrinsics reference 
manual. This gives you a specific diagnosis of the problem. 
Correct the situation and then resubmit the job or proceed 
with the session. 


For error code 3, redefine the file with larger limits and 
then resubmit the job or proceed with the session. 
Depending upon the remote computer system with which 
you are communicating, the output data set may or may not 
be recoverable. 


3-6. LINE ERRORS 


Messages issued as the result of line errors indicate that 
the communications link could not be established or you 
tried to perform on-line input/output without having 
established the communications link. A line error always 
causes a batch job to terminate. In an interactive session, 
after issuing the error message the Emulator displays a # 
on your terminal to prompt you for the next Emulator 
command. 


o-7. ERROR MESSAGE 
The format of the line error message is as follows: 


*kEE LINE ERROR: x 
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where 


x 
is a digit specifying the type of error, as follows: 


O= Line not yet established. 


Table 5-1 shows the most frequent user line errors, their 
probable causes and recovery actions. 


5-8. COMMUNICATIONS SYSTEM (CS) 
ERROR CODES 


The format of the input/output error message is as follows: 


EEE CS ERROR: x, yyy, 2z 


where 


Xx 
is a digit specifying the type of error, as follows: 


0 = Line open error 
1 = Line read error 
2 = Line write error 


YYY 
is anumber specifying the CS irrecoverable error code, as 
shown in Table 5-2. 


ZZ 
is a number specifying the CS recoverable error code 
returned from the SSLC driver, as shown in Table 5-3 (zz 
is a function of the yyy error code and may not appear). 


Table 5-2 contains the CS irrecoverable error codes while 
table 5-3 contains the CS recoverable error codes. An error 
is irrecoverable when the system is unable to recover from 
the error and it is up to the user to take corrective action. 


Table 5-1. Common User Line Errors 









**E* CS ERR 0, 12 


eee CS ERR 0, 11 
or 
eee CS ERR 0, 13 






*#EE LINE ERROR O 











#RJLINE command. 


You used an erroneous logical device 
number or device class name. 


Another user has the line, or the line 
is unavailable for some other reason 


You tried to perform on-line I/O 
(#RJIN, #RJOUT, #RJLIST, or 
#RJPUNCH) before issuing an 


Recovery Procedure 


Job: Correct the #RJLINE command 
and resubmit the job. 


Session: Enter a correct #RJLINE 
command. 



















Job: Resubmit when the line be- 
comes available. 

Session: Terminate and then restart the 

Emulator when the line be- 

comes available. 























Job: Add an #RJLINE command to 
your deck and resubmit the job. 

Session: Issue an #RJLINE command and 

then proceed with the session. 
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The system can recover from a recoverable error and no 
action is required by the user; a recoverable error code may 
follow an irrecoverable error code to inform the user of the 
error. The more frequent I/O errors, their causes and 
recovery actions are described in Table 5-4. Frequent deck 
set-up errors are listed in Table 5-5. 


3-9. PROCEDURE ERROR 


Messages issued as the result of a procedure error indicate 
that something was wrong with a procedure that you 
specified in an Emulator command. A procedure error 
always causes a batch job to be terminated. In an 
interactive session, after issuing the error message the 


Interpreting Messages 


Emulator displays # on your terminal to prompt you for the 
next Emulator command. 


5-10 ERROR MESSAGE 

The format of a procedure error message is: 
eX PROCEDURE ERROR: xx 

where 


XX 

is a two-digit error code. This code is described in the 
Loader Errors table under MPE Diagnostic Messages in 
the MPE Intrinsics Reference Manual. 


Table 5-2. CS Irrecoverable Error Codes Used With The Emulator 


Code Code 


Request completed successfully. 

Invalid driver name. 

Driver not in system. 

Driver not compatible with line’s attributes. 
This line not configured to change drivers. 
Undefined line. 

Line not available. 

Not CS line. 

CS line in use. 


ID sequence length greater than 16 characters. 


Buffer size greater than 4096 words. 


Phone number length greater than 20 char- 


acters. 


Character in phone number was not numeric 


or a hyphen. 

Local mode not compatible with line type. 
Could not open trace file. 

Trace file record size was too small. 

User does not have CS capability. 

No line specified. 

Insufficient memory space. 


No virtual memory available for trace and/or 


buffering. 

I/O error on trace file. 

Operator responded “no” to a dial message. 
No phonelist for dial attempt. 


Nonresponding Synchronous Single Line Con- 


troller (SSLC). 

SIO transfer error. 

Modem became not ready. 

Carrier loss occurred on modem. 

SIO timing error (data overrun). 

Connect timeout occurred. 

Remote station rejected the connection. 
Power failure occurred. 

Local timeout occurred. 





An internal error was detected by the CS 
driver. 

Remote protocol error occurred. 

Remote station sent shutdown sequence and 
disconnected. 

Remote sent shutdown sequence and discon- 
nected before the last I/O request was issued. 


An internal error was detected by MPE. 
Current I/O operation aborted. 

Invalid Emulator request was detected by CS 
driver. 

Remote not ready to receive (remote sent a 
NAK sequence in response to local line bid). 
Remote rejected the line bid. 

Remote primary station bid for the line while 
local station was also bidding. 

Remote has requested to send (an RVI sequence 
was received), 

Retry count exhausted. 

Unexpected text was received. 

Receive timeout occurred while waiting for 
text from the remote station. 

Remote sent end-of-tansmission. 

Remote sent end-of-transmission sequence and 
disconnected before the last I/O request was 
issued. 

During execution of a conversational write 
with the output buffer specified or the input 
buffer, the remote station requested a resend 
of the output buffer but its contents had been 
modified while receiving from the remote. 
Remote sent an ACK sequence in response to 
local acknowledgment. 

Remote sent a NAK sequence in response to 
local acknowledgement. 

Remote sent an RVI sequence in response to 
local acknowledgment. 

Line bid timeout occurred while waiting for 
the remote system’s line bid. 
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Table 5-3. CS Recoverable Error Codes Used With The Emulator 


Code Code 
(Decimal) Meaning (Decimal) Meaning 


No recoverable error occurred. Received enquiry character after sending text. 
Invalid ID sequence received. Remote requested a resend of local’s last re- 
Received unintelligible sequence. sponse. 

Block check character error. Remote requested a resend of last text. 
Remote did not respond to text. Received end-of-transmission character while 
Received incorrect acknowledgment. line was in control state. 

Remote attempted to bid for the line. Received text overflow. 

No response to line bid. Data overrun occurred on SIO multiplexer. 
Received unintelligible sequence after sending 
text. 
































ONIH MAL WNHO 







Data transfer error occurred on SIO multiplexer. 


Table 5-4. Common CS Line Errors 


What Happened Probable Cause Recovery Procedure 



















ee CS ERR 1, 57 
or 


*#EE CS ERR 2, 57 









Terminate the session and 
try again later. 


The remote site’s tele- 
phone was busy or did not 
answer. 


You (or the computer oper- 
ator) entered NO in re- 
sponse to the DIAL REQD 
message. 














*keE CS ERR 1, 101 The Synchronous Single Something may be wrong 

or Line Controller failed to with the Synchronous 

CS ERR 2, 101 respond to an I/O instruc- Single Line Controller. 
tion. 


Reissue the particular 
Emulator command. If the 
same error occurs, call the 
nearest HP Sales and Ser- 
vice Office. 













































*ee* CS ERR 1, 102 A timing or parity error Something may be wrong Reissue the particular 






or occurred in the HP 3000 in the SIO bus. Emulator command. If the 
*kEK CS ERR 2, 102 SIO bus. same error occurs, call the 

or nearest HP Sales and Ser- 
**** CS ERR 1, 105 vice Office. 

or 


*##* CS ERR 2, 105 
























The remote processor may 
have terminated the com- 
munications link because 
you accidntally specified 
the wrong transmission 
code in the #RJLINE com- 


mand. 


Correct the LINECODE= 
parameter in the 
# RJLINE command and 
reissue the command. 






**** CS ERR 1, 103 
or 
**** CS ERR 2, 103 










The “Data Set Ready” 
(CC) signal from the MO- 
DEM has changed from 
“set” to “clear” (i.e., the 
communications link has 
been terminated). 























The remote processor may 
have terminated the com- 
munications link because 
you did not adhere to its 
log-on conventions. 


Correct the log-on card (or 
the #RJIN command that 
sends it) and restart the 
session. 
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Table 5-4. Common CS Line Errors (Continued) 


What Happened Probable Cause Recovery Procedure 


Restart the session and 
enter the data faster this 
time. 











If you were entering an in- 
put data set through an in- 
teractive terminal, the re- 
mote processor may have 
timed-out (and terminated 
the communications link) 
because you were not en- 
tering the data fast 
enough. 




























The remote processor may 
have shut down in the 
middle of your job. 


Call the operator at the 
remote site and find out 
what their problem is. 







Switched: 
Restart the session and 
re-dial. 

Private: 

Run a job that has worked 
okay in the past. If it fails 
also, call the nearest HP 
Sales and Service Office. 


The telephone connection 
may be bad. 
























If it runs okay, something 
is wrong with the data 
your most recent job was 
transmitting. 




















The remote processor re- 
quires a terminal ID and 


Correct the ID= parameter 
in the #RJLINE com- 











«ee CS ERR 1, 153 A NAK or EOT or DLE/ 



























or EOT was received in re- ; : 
«ek CS ERR 2. 153 sponse to your line bid you either supplied an mand and then re-issue 

a F (i.e., in response to the erroneous one or none at the #RJLINE command. 
«ee CS ERR 2,203 | ENQ generated by an | @ll. 

or #RJIN command). 













Terminate the session and 
try again at a later time. 


#eX CS ERR 2, 204 The remote processor cur- 
rently does not want to 


receive input. 















or 





Terminate the session and 
call the operator at the re- 
mote site to find out what 
their problem is. 

















EK CS ERR 1, 158 
or 
ee CS ERR 2, 158 


A DLE/EOT sequence was 
received. 


A DLE/EOT sequence al- 
ways indicates that the re- 
mote processor is termin- 


ating the communications 
link. 


Examine your input deck 
for the errors shown in 
Table 5-5. 





















If you find errors, correct 
them and restart the ses- 
sion. 


You may have set up your 
input deck incorrectly. 
Some common errors of 


this sort are shown in 
Table 5-5. 
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Table 5-4. Common CS Line Errors (Continued) 


If your deck seems to be 
correct, call the operator 
at the remote site and find 
out what their problem is. 
Note: Some RJE systems 
use DLE/EOT as a job ter- 
minator after trans- 
mitting the last available 
output. If you were receiv- 
ing output when the mes- 
sage was issued and if 
this is a characteristic of 
the RJE system with 
which you are communi- 
cating, ignore the mes- 
sage. This message may 
be inhibited by supplying 
the XEND parameter of 
#RJLINE. 


EE CS ERR 1, 201 
or 
eee CS ERR 2, 201 


















Only your computer op- 
erator knows for sure. 


The operator of your HP 
3000 Computer System 
entered an ABORTIO 
command for your Syn- 
chronous Single Line Con- 
troller through the opera- 
tor’s console. 


Ask your computer opera- 
tor. 







eee CS ERR 1, 209 





Receive Continue Time- 
Out. After the remote pro- 
cessor began transmitting 
output, a period of inac- 
tivity occurred in which 





Some RJE systems ter- 
minate the final output 
transmission by letting 
the other end of the line 
time-out. 








Check the output that you 
received. If it seems to be 
all there, ignore the error 
the error message. 





















no data was received with- 
in the allowed time (20 
seconds). 






The EOT terminating the 
final output data set may 
have been garbled. 


Check the output that you 
received. If it seems to be 
all there, ignore the error 
message. 



















Something may have hap- 
pened to interrupt the 
transmission in the mid- 
dle of a data set. 


Check the output that you 
received. If the time-out 
occurred in the middle of 
a data set, issue an 
#RJEOD command and 
then re-issue the particu- 
lar Emulator output 
command. 
































*kkK CS ERR 1, 217 Line Bid Time-Out. The Try again at a later time. 
remote processor did not 
bid for the line within the 
allowed time (3 minutes or 
the specified WAIT= 


time). 


The remote processor cur- 
rently has no output ready 
to send. 
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Message 


*KK CS ERR 2, 205 


eK CS ERR 2, 206 


**** CS ERR 2, 207, 2 


*ek# CS ERR 2, 207, 4 


Table 5-4. Common CS Line Errors (Continued) 


If your HP 3000 is a sec- 
ondary station, this means 
that an ENQ was received 
in response to your line bid 
(i.e., in response to the 
ENQ generated by a 
#RJIN command). 


An RVI was received 
while transmitting data. 


A NAK was received 


in response to a transmis- 
sion block on 16 succes- 
sive tries. 


Response Time-Out. The 
remote processor did not 
respond within 16 tries 
(48 seconds) when the 
Emulator transmitted an 
enquiry or data block. 


The remote processor 
want to transmit some- 
thing. 


The remote processor has 
a high priority message 
to transmit. 


You may accidentally be 
generating bisynch con- 
trol codes in your data 
(this could result from 
mispunched data or from 
transmitting binary data 
in the non-transparent 
mode). 


The communications line 
may be bad, causing ir- 
recoverable parity errors. 


There may be a hardware 
or software malfunction 
at either end of the line. 


You may have accidental- 
ly specified the wrong 
transmission code. 


You and the remote pro- 
cessor may both be pri- 
mary stations and both be 
trying to transmit data as 
the first i/O operation. 
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Issue an #RJOUT com- 
mand to find out what the 
remote processor wants to 
transmit. 


Issue an #RJOUT com- 
mand to find out what the 
remote processor wants to 
transmit. 


If you are transmitting 
binary data, make sure 
you specified XPARENT= 
YES in your #RJIN com- 


mand. 


If you are transmitting 
ASCII or EBCDIC data, 
check the data for mis- 
punched characters (to the 
extent that it is practical 
to do so). 


Switched: 
Restart the session and re- 
dial. 


Private: 

Run a job that has worked 
in the past. If it fails, call 
the nearest HP Sales and 
Service Office. 


If it runs, something is 
wrong with the data your 
most recent job was trans- 
mitting. 


Call the nearest HP Sales 
and Service Office. 


Correct the LINECODE= 
parameter in your 
#RJLINE command and 
re-issue the #RJLINE 
command. 


Call the operator at the re- 
mote site and get co- 
ordinated. 
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Table 5-4. Common CS Line Errors (Continued) 


What Happened Probable Cause Recovery Procedure ~ 3 


The communications line 
may be bad or there may 
be a hardware or software 
malfunction at either end 
of the line. 







eeKE CS ERR 2, 210 











An EOT was received 
while transmitting data. 


The remote processor for 
some reason is not able to 
continue. This may, but 
does not necessarily, indi- 
cate that the communica- 
tions link has been ter- 
minated. 
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Switched: 

Restart the session and re- 
dial. 

If the same error occurs, 
call the remote site and 
find out if they are having 
problems. 











If all is okay at the remote 
site, call the nearest HP 
Sales and Service Office. 





Private: 
Call the remote site and 
find out if they are having 
problems. If all is okay at 
the remote site, call the 
nearest HP Sales and Ser- 
vice Office. 





If the communications 
link is still present, re- 
try the #RJIN command. 










If the communications 
link was terminated, try 
to re-establish it. If it can 
successfully be re-estab- 
lished, retry the #RJIN 
command. 








If the communications 
link cannot be re-estab- 
lished or if the #RJIN 
command continues to 
fail, call the operator at 
the remote site and find 
out what their problem is. 
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Table 5-5. Common Deck Set-Up Errors 



















input (e.g., during log-on). 


EBCDIC data. 





cating. 


5-11. PROBABLE CAUSES 
Either the Emulator could not find the specified procedure 
or something was wrong with the procedure. 


5-12. RECOVERY PROCEDURES 

Make sure that the procedure name which you used is 
correct, that you are referencing the proper library, and 
that the procedure actually exists. If that does not solve the 
problem, examine the procedure itself and correct it. 


5-13. ROUTING ERRORS 


Messages issued as the result of routine errors indicate that 
a routed punched output data set was received when it was 
not expected (i.e., when a #RJLIST command was being 
executed) or a routed list output data set was received when 
it was not expected (i.e., when an #RJPUNCH command 
was being executed). The command which was being 
executed when the error occurred is terminated. In an 
interactive session, after issuing the error message the 
Emulator displays a # on your terminal to prompt you for 
the next Emulator command. In a batch job, processing 
continues only if the next Emulator command is a different 
type of output command than the one which was just 
terminated. If the next command is #RJIN, #RJLINE, 
#RJEOD, or #RJEND the job is terminated; if the next 
command is the same type of output command which was 


Wrong emulator type specified in #RJLINE command. 


Probable Message 
(CS Error Message #) 


Wrong LINECODE= specified in #RJJLINE command. 103 or 207, 4 


COMPRESS= NO (3780) or TRUNCATE=NO not specified in the #RJIN 
command when the remote processor require uncompressed or untruncated 


XPARENT= YES not specified in the ¢RJIN command when transmitting 
binary data. The same error condition can arise from mispunched ASCII or 


Forgot to log-on to the remote system when log-on is required. 158 or 103 


More than one user trying to log-on with the same ID (i.e., the same ID= 
parameter in the #RJLINE command or the same ID in the remote sys- 
tem’s log-on procedure). The applicability of this condition is dependent upon 
the characteristics of the remote system with which you are communi- 






207, 2 or 207, 4 (transmitting) 
158 (receiving) 

It is also possible that no mes- 
sage will be issued but that the 
output will be garbled. 


158 or 103 
207, 4 or 207, 2 


























just terminated, then the routing error still exists and the 
next command beyond that will be examined before 
deciding whether or not the job should be terminated. 


5-14. ERROR MESSAGE 
The format of a routing error message is: 
**e* ROUTING ERROR: x 


where 


x 
is a digit specifying the type of error, as follows: 


0 = Routed list output data set was received when it 
was not expected. 


1 = Routed punched output data set was received when 
it was not expected. 


5-15. PROBABLE CAUSES 


You used an #RJLIST or #RJPUNCH command when you 
should have used #RJOUT. 


3-16. RECOVERY PROCEDURES 


In an interactive session, issue an #RJOUT command. 


Interpreting Messages 


In a batch job, if the job was terminated add the appropriate 
output command(s) to your deck and resubmit the job. 
Depending upon the remote computer system with which 
you are communicating, the output data set may or may not 
be recoverable. If, due to the structure of your job deck, the 
job was not terminated, make sure that you received all 
expected output. If you did not receive all expected output, 
be sure to include the appropriate output command(s) in 
your next job deck to retrieve the outstanding output. 


5-17. COMMAND ERRORS 


Messages issued as the result of command errors indicate 
that something was wrong with an Emulator command (for 
example, the command was totally unrecognizable or it 
contained syntax errors). A command error always 
terminates a batch job. In an interactive session, after 
issuing the error message the Emulator displays a # on 
your terminal to prompt you for the next Emulator 
command. 
5-18. ERROR MESSAGES 
The formats of the command error messages are: 
ke COMMAND ERROR: x 
ERE SYNTAX ERROR: y,z 
where 


X 
is a digit specifying the type of error, as follows: 


Q = Invalid command (the command was totally 
unrecognizable). 


1 = Command too long. 


2 = Too many parameters. 


is a digit specifying the type of error, as follows: 
0 = Invalid keyword. 
1 = Duplicate keyword. 
2 = Invalid command construction. 
3 = Invalid parameter. 
4 = Invalid numeric parameter. 
5 = Required parameter missing. 
Z 
is a digit specifying the number of the erroneous 


parameter, such as 3 meaning that the third parameter 
is In error. 
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Note: When issuing the **** SYNTAX 
ERROR: y, z error message, the Emulator 
always counts leading, but not trailing, 
non-keyword parameters regardless of 
whether they were supplied or omitted. 
This means that if one or more of the 
non-keyword parameters are omitted, 
the parameter pointer (z) includes the 
omitted non-keyword parameters and 
you must adjust the pointer mentally in 
order to locate the erroneous parameter. 
For example, if you supplied an #RJOUT 
command which does not contain the 
output file reference and count 
parameters, the parameter pointer in a 
**** SYNTAX ERROR:y, z error 
message is two greater than what you 
might otherwise expect. In such a case, if 
the second supplied keyword parameter 
is in error, z would be four instead of the 
expected two. 


5-19. PROBABLE CAUSES 

You made an error in coding, keypunching, or entering the 
particular command. 

5-20. RECOVERY PROCEDURES 


For a batch job, correct the erroneous command and 
resubmit the job. 


In an interactive session, correct the erroneous command 
and re-enter it. 


5-21. RIN ERRORS 


Messages issued as the result of a RIN error indicate that 
an invalid resource identification number (RIN) or an 
invalid RIN password was used. A RIN error always causes 
a batch job to be terminated. In an interactive session, after 
issuing the error message the Emulator displays a # on 
your terminal to prompt you for the next Emulator 
command. 


5-22. ERROR MESSAGE 


The format of a RIN error message is: 
ee RIN ERROR: 0 
5-23. PROBABLE CAUSES 
You used an illegal RIN or RIN password. 
§-24. RECOVERY PROCEDURES 


For a batch job, correct the RIN or RIN password and 
then resubmit the job. 


In an interactive session, correct the RIN or RIN 
password and then re-enter the command. 
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Table A-1 summarizes the features of the IBM 2780 Data Transmission Terminal and the IBM 3780 Data Communication 
Terminal. The information is presented in such a way that you can either reference specific information for one of the two 


terminals or compare the capabilities of one terminal against the other. 


IBM 2780/3780 COMPARISON 
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Table A-1. IBM 2780/3780 Comparison 


FEATURE IBM 2780 IBM 3780 


400 cpm card reader. 600 cpm card reader. 
355 cpm card punch (optional). 359 cpm card punch (optional). 
300 Ipm line printer (optional). 425 lpm line printer. 


Half/Full Duplex Protocol Half duplex only. Half duplex only. 


Permissible Communications Net- Point-to-Point (leased or switched). Point-to-Point (leased or switched). 
works Multipoint (2- or 4-wire). Multipoint (2- or 4-wire). 


Permissible Transmission Codes ASCII (non-transparent mode only). ASCII (non-transparent mode only). 
EBCDIC (transparent or non-trans- EBCDIC (transparent or non-trans- 
parent modes). parent modes). 
Six-bit transcode. 





Peripheral Devices 












































ASCII: Qdd parity VRC and ASCII: 
8-bit LRC. 
EBCDIC: 16-bit CRC. 


Six-bit transcode: 12-bit CRC. 


Permissible Transmission Rates 1200, 2000, 2400, 4800 bps. 1200, 1800, 2400, 3600, 4800, 
7200 bps. 


Odd parity VRC and 
8-bit LRC. 
EBCDIC: 16-bit CRC. 


Error Checking 

















Buffer(s) One 400-byte buffer used for either Two 512-byte buffers used simul- 
input or output taneously for input and output. 





Accept Horizontal Tabulation YES (optional) YES. 
Codes? 
Accept Vertical Forms Control YES. YES. 
Codes? 


Transmit and Receive in Trans- YES (optional; applies only to YES (optional; applies only to 
parent Mode? EBCDIC mode). EBCDIC mode). 







Short-Record Truncation? YES (user must supply EM con- YES (done automatically; user does 
trol characters in the data). not need to supply EM or IRS con- 
trol characters in the data). 


Blank Compression? NO. YES (done automatically; user does 
not need to supply any special 
characters in the data). 

0. 






Maximum Blocking Factor 2 (optionally 7) Non-Transparent Mode: 255 
Transparent Mode: 1 (optionally 6). 


Generate WACK and TTD Se- N YES. 
quences When Temporarily Unable 


to Transmit or Receive? 


















Intermediate Block Terminator ASCII: US BCC 


Character 


ASCII: RS (no BCC) 
EBCDIC: IUS BCC EBCDIC: IRS (no BCC) 
Six-bit transcode: ITB BCC Receive Mode: Will accept IUS BCC. 


Recognize WACK? YES (receive mode only). YES. 


Component Select Codes (Point-to- ESC followed by any carriage con- DC1 specifies printer. 
Point Only) trol code specifies printer. DC2 or DC3 specifies punch. 
ESC 4 specifies punch. 











SOH at Start of Received Text Treated as an STX. Not recognized. 





A-2 





“y 


’ 


APPENDIX 


arrest 
MODEM OPTIONS 


Tables B-1 through B-6 present the Bell System options for MODEMs which can be used with the HP 2780/3780 Emulator. 
Wherever possible, recommendations for which option to choose are also shown. 


Modems normally used for full-duplex operation are models 201B, 208A, and 209A. 
Models normally used for half-duplex operation are 201A, 201C, and 208B. 


When ordering a modem, it is customary to specify that it provide continuous carrier and continuous request-to-send. 


Type of MODEM: Bell System Type 201A3 Data Set. 


Type of Line: Public Telephone Network (Switched). 





Transmission Rate: 2000 bits-per-second. 


Table B-1. 201A3 Options and Recommendations 































OPTION NUMBER DESCRIPTION RECOMMENDATION 
d ’ Al EIA interface. 
: A2 Contact interface. po EGUITEE) 
B3 With alternate voice. 
B4 Without alternate voice. 
C5 With new sync. . 
C6 Without new sync. ee Creuiree 
D7 Half duplex (2-wire). D7 
D8 Full duplex (4-wire). 
Eg 4-wire continuous carrier. oy 
10 4-wire carrier controlled by REQUEST TO SEND. 


*If option B3 is selected and automatic answering is to be used, the automatic answering capability is normally 
provided as a key-controlled function. If you want the automatic answer to be permanently wired, then state so in 
the Remarks column on the Bell System order form. 


**If option D7 is selected, the E options have no meaning and should be ignored. 
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Type of MODEM: Bell System Type 201B3 Data Set. 
Type of Line: Private Leased Line. 


Transmission Rate: 2400 bits-per-second. 


Table B-2. 201B3 Options and Recommendations 


OPTION NUMBER DESCRIPTION RECOMMENDATION 


EIA interface. 
Contact interface. 


. With alternate voice. 
Without alternate voice. 
With new sync. ; 


Half duplex (2-wire). 
Full duplex (4-wire). 


Al (required) 


4-wire continuous carrier. 
4-wire carrier controlled by REQUEST TO SEND. 





*If option B3 is selected and automatic answering is to be used, the automatic answering capability is normally ) 
provided as a key-controlled function. If you want the automatic answer to be permanently wired, then state so in 
the Remarks column on the Bell System order form. 


**If option D7 is selected, the E options have no meaning and should be ignored. 
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Type of MODEM: Bell System Type 201C Data Set (also called DATAPHONE 2400). 
Type of Line: Public Telephone Network (Switched) or Private Leased Line. 


Transmission Rate: 2400 bits-per-second. 


Table B-3. 201C Options and Recommendations 


OPTION NUMBER DESCRIPTION RECOMMENDATION 


Al Transmitter internally timed. Al (required) 
A2 Transmitter externally timed. q 
Without 801 Automatic Calling Unit. 


With 801 Automatic Calling Unit. oP 


ELA interface. ; 
Contact interface. Poe 
Without automatic answer. 

| D8 

With automatic answer. 

Automatic answer permanently wired. 


“ Ei ts 
Automatic answer key-controlled. ither 








*If option D7 is selected, the E options have no meaning and should be ignored. 
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Type of MODEM: Bell System Type 208A Data Set (also called DATAPHONE 4800). 
Type of Line: Private Leased Line. 


Transmission Rate: 4800 bits-per-second. 


Table B-4. 208A Options and Recommendations 


OPTION NUMBER DESCRIPTION RECOMMENDATION 
Al Transmitter internally timed. 
Transmitter externally timed. Ad (required) 


B3 Continuous carrier. 
B4 Switched carrier. 


C5 Switched REQUEST TO SEND. 


C6 Continuous REQUEST TO SEND. 

D7 One second holdover used. D7 
One second holdover not used. 
With new sync. : 
Without new sync. i 
CC ON when analog loop is present. Fli 
CC OFF when analog loop is present. 
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Type of MODEM: Bell System Type 208B Data Set (also called DATAPHONE 4800). 
Type of Line: Public Telephone Network (Switched). 


Transmission Rate: 4800 bits-per-second. 


Table B-5. 208B Options and Recommendations 
OPTION NUMBER DESCRIPTION RECOMMENDATION 
Transmitter internally timed. ; 
ae Transmitter externally timed. mp nequured) 


Al 
A2 
B3 Without 801 Automatic Calling Unit. 
B4 With 801 Automatic Calling Unit 
CS CC OFF when analog loop is present. CE 
( C6 CC ON when analog loop is present. 
D7 Without automatic answer. 
D8 
D8 
E9 
E10 













With automatic answer. 







Desk mounting. 


Rack or cabinet mounting. Either 
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Type of MODEM: Bell System Type 209A Data Set (also called DATAPHONE 9600). 
Type of Line: Private Leased Line (3002 type four-wire) with D1-type conditioning (no C-type conditioning). 
Transmission Rate: 9600 bits-per-second. 


Description of 


Application: Point-to-Point 9600 bps operation. 


Table B-6. 209A Options and Recommendations 


OPTION NUMBER DESCRIPTION 
Al Transmitter Timing supplied by Data Set. 
A2 Transmitter Timing supplied by Computer/Terminal. 
B3 Data Set Ready interface lead ON for Analog Loopback Mode. 
B4 Data Set Ready interface lead OF F for Analog Loopback Mode. 
C5 Transmitter Timing slaved by Receiver. 
C6 Transmitter Timing not slaved by Receiver. 


Elastic Store option enabled (IN). 
Elastic Store option disabled (OUT). 











RECOMMENDATION 


Al (required) 



























Continuous Carrier operation. 
Switched Carrier operation. 


Fil Switched Request-to-Send operation. . 
F12 Continuous Request-to-Send operation. F12 
Grounding: 
Protective Ground to Signal Ground. AA to AB 


omen 


Without Alternate Voice 
The Data Set normally is supplied without a hand set. 

If the 209A Modem will be used in multiplexing applications, the options shown do not apply. In this case, 

refer to Bell System Data Communications Technical Reference, Data Set 209A Interface Specifications 

(Publication 41213) for additional information. 













Notes: *F11 and F12 are significant only if E10 is selected. 
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Table C-1 presents all of the ASCII, EBCDIC, and Hollerith codes which the HP 2780/3780 Emulator can handle. Note 
that if INCODE=BINARY or OUTCODE=BINARY is specified in an Emulator #RJIN, 4RJOUT, #RJLIST, or 
#RJ PUNCH command, no conversion occurs; the Emulator merely passes along whatever bit patterns it receives from the 
remote processor or from the specified input file. 
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Table C-1. ASCII, EBCDIC, and Hollerith Codes 





HOW TO USE THIS TABLE 


The table is sorted by character code, each code being represented by its decimal, octal, and hexadecimal 
equivalent. 


Each row of the table gives the ASCII and EBCDIC meaning of the character code, the ASCII¢®EBCDIC 
conversion code, and the Hollerith representation (punched card code) for the ASCII character. 


The following examples describe several ways of using the table: 


Example 1: Suppose you want to determine the ASCII code for the $ character. Scan down the ASCII graphic column 
until you locate $, then look left on that row to find the character code — 36 (dec), 044 (oct), and 24 (hex). This is the 
code used by an ASCI! device (terminal, printer, computer, etc.) to represent the $ character. Its Hollerith punched card 
code is 11-3-8. 


Example 2: The character code 5B (hex) is the EBCDIC code for what character? Also, when 5B is converted to ASCII 
(for example, by FCOPY with the EBCDICIN option), what is the octal character code? First, locate 5B in the hex 
character code column and move right on that row to the EBCDIC graphic which is $. The next column to the right 
gives the conversion to ASCII, 044. As a check, find 044 (oct) in the character code column, look right to the ASCII 
graphic column and note that $ converted to EBCDIC is 133 (oct) which equals 5B (hex). 





CHAR CODE CHAR CODE ASCII | eecoic 
to 


Dec Oct Hex D Oct Hex EBCDIC 
(Oct) 
0 


ec 
00 12-0-1-8-9 48 3 
12-1-9 
12-2-9 
12-3-9 


7-9 

0-5-8-9 
0-6-8-9 
0-7-8-9 


11-6-9 
12-5-9 
0-5-9 
12-3-8-9 


12-4-8-9 
12-5-8-9 
12-6-8-9 
12-7-8-9 
12-11-1-8-9 
11-1-9 
11-29 
11-3-9 


4-8-9 





° OD NOL WHO 
OMA NOOR WHO 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 


vVi A- 








F—-- -“N<XK Scca MYO VIOZZr AC-TaA DAMA OWOOHO 
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Table C-1. ASCII, EBCDIC, and Hollerith Codes (Continued) 


to to 
Dec Oct Hex pied EBCDIC bd ASCII 
Gp (Oct) Ph | (oct) 


BO 12-11-8-9 
11-1-8 
11-0-2-9 
11-0-3-9 
11-0-4-9 
11-0-5-9 
11-0-6-9 
11-0-7-9 
11-0-8-9 
0-1-8 
12-11-0 
12-11-0-1-9 
12-11-0-2-9 
12-11-0-3-9 
12-11-0-4-9 
12-11-0-5-9 


12-11-0-6-9 
12-11-0-7-9 
12-11-0-8-9 
12-0-1-8 








CHAR CODE ASCII EBCDIC 
to 
Cnti/ Cat’ | asc 
1-8 = 


96 140 60 
12-0-1 


12-0-2 



















































xo-orF ero na age 








“nr 9010337 





t 12-0-2-8 
u 12-0-3-8 
v 12-0-4-8 
w 12-0-5-8 





12-0-6-8 
12-0-7-8 
12-11-1-8 
12-11-2-8 


12-11-3-8 





-TroaTm™m™oao owp™ 






TN < x 























Cy 








S 
12-11-4-8 
12-11-5-8 > 

DEL 12-11-6-8 





























12-11-7-8 
11-0-1-8 
11-0-2-8 
11-0-3-8 


11-0-4-8 
11-0-5-8 
11-0-6-8 
11-0-7-8 


12-11-0-1- 
12-11-0-1 

12-11-0-2 
12-11-0-3 


12-11-0-4 
12-11-0-5 
12-11-0-6 
12-11-0-7 


12-11-0-8 
12-11-0-9 
12-11-0-2-8 
12-11-0-3-8 


12-11-0-4-8 
12-11-0-5-8 
12-11-0-6-8 
12-11-0-7-8 


12-0-2-8-9 
12-0-3-8-9 
12-0-4-8-9 
12-0-5-8-9 
12-0-6-8-9 
12-0-7-8-9 
12-11-2-8-9 
12-11-3-8-9 


12-11-4-8-9 
12-11-5-8-9 
12-11-6-8-9 
12-11-7-8-9 


11-0-2-8-9 
11-0-3-8-9 
11-0-4-8-9 
11-0-5-8-9 
11-0-6-8-9 
11-0-7-8-9 

12-11-0-2-8-9 
12-11-0-3-8-9 


12-11-0-4-8-9 


11-0-1-8-9 
0-1-9 
0-2-9 
0-3-9 


0-4-9 
11-5-9 
12-6-9 
11-7-9 


0-8-9 
0-1-8-9 
0-2-8-9 
0-3-8-9 
0-4-8-9 
12-1-8-9 
12-2-8-9 












- JF or f& a oO OF ® 
DO VO2ZES r-xAcw 

































12-11-0-1-8-9 


re 






















N< xS<c AM 




































12-0-4-9 


12-0-5-9 
12-0-6-9 
12-0-7-9 
12-0-8-9 
12-1-8 
12-11-1-9 
12-11-2-9 
12-11-3-9 


12-11-4-9 



























—OMN NOL WN O 















12-11-5-9 12-11-0-5-8-9 
12-11-6-9 12-11-0-6-8-9 
12-11-7-9 12-11-0-7-8-9 
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SUMMARY OF 
EMULATOR COMMANDS || 0 | 


This appendix summarizes the ten Emulator commands. For each command, the following information is presented: 


The command mnemonic 

The allowable parameters 

A brief description of the function of the command 

A paragraph number indicating where the command is described in this manual 


In the presentation of the parameters, brackets [ | indicate that the particular item is optional and braces { } indicate that 
one of the enclosed items is to be chosen. Uppercase items, punctuation, and parentheses must be used as shown in the 
parameter format. Lowercase items are variables which you must replace with the desired file reference, password, value, 
etc. 


Command Text 
Mnemonic Parameters Command Function Reference 








2780 
{ 3780 \ Defines the communications link. 3.1 
Eee 
an ECODE= {5 CDIC | 
_ JDIAL [; “phone number’ I} 
| connecr- ANSWER 


;MAXRPB= blocking factor | 


[ 
| ;ID=terminal identification | 
[;RIN= rin |, password | | 

[3 


CHNL3=x] 


[;XEND] 
mace. fan [mask [ [numentries][, wear] 


YES 
[;DEV=n] ‘Lock: | pri | HIGH 
NOW NORMAL 


[input file reference | 









Transmits one input data set to q 3-7 


the remote processor. 





[;REC=[ start rec |[,end rec] ] 


YES 
on tog 


| xpanenr- bes }] 


YES 
 wauncare- {X 9 | 
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Command Text 
Mnemonic Parameters Command Function Reference 


ASCII 
#RJIN SINCODE= 4 EBCDIC 
BINARY 
[;MAXSIZE=nnz ] 
[;XEOF] 


[ outp ut file reference | Initiates the receipt of routed out- 
put data sets and/or unrouted list 

#RJLIST 
#RJPUNCH 








q 3-17 

























[count | output data sets from the remote 


processor. 










[WAIT=[m][s]] 
ASCH 
;OUTCODE= } EBCDIC 
BINARY 


[ ;OUTSIZE= nnn | 










Initiates the receipt of unrouted q 3-25 
list output data sets from the re- 


mote processor 


[dist file reference | 
[, count | 


or 









Initiates the printing of list output 
data sets from disc or magnetic 
tape. 


[;WAIT= [m] [ .8]] 







[;SOURCE= source file reference | 


ASCII 
OUTCODE= { EBCDIC 
BINARY 
[ ;sFORMSMSG= message | 


;OUTSIZE= nnn | 


_ SYES 
;AUTOPAGE= Pe | 



















Initiates the receipt of unrouted q 3-34 
punched output data sets from 


the remote processor 


[ 
[punch file reference | 
[count] 


or 






Initiates the punching of punched 
output data sets from disc or 
magnetic tape. 


[;WAIT=[m][,s]] 





[;SSOURCE=source file reference | 


ASCII 
;OUTCODE= { EBCDIC 


Binary 





3 by 
B=) Ee s 
ang Ay =: 
7 ge . DS & & E 


[;OUTSIZE= nnn | 
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Command Text 
Mnemonic Parameters Command Function Reference 


Transmits an KOT control charac- 
ter (end-of-file) to the remote 
processor. 


(none) Terminates the HP 2780/3780 
Emulator subsystem. 


#RJIO message (batch) Initiates transmission of a one-line 
message to the remote processor 

#|RJIO] message (session) and initiates receive mode for the 
receipt of routed data from the 
remote processor. RJIO optional 
only during session and if first 
character of message is a spe- 
cial character. 


#RJINFO Initiates a file display printing of 
the communications line. 


#RJDEBUG Sets the emulator into the debug 
mode, allowing the user access to 
the debugging facilities. 























CONFIGURING THE EMULATOR 
| E 


This appendix describes how to configure the MPE Operating System to include the Emulator software. 


INTRODUCTION 


First, the Emulator hardware (the HP 30055A Synchronous Single-Line Controller) must be installed as described in the HP 
380055A Synchronous Single-Line Controller Installation and Service Manual. During hardware configuration, determine the 
SSLC Device Address (the hardware DRT), the highest Device Address (highest DRT), and the logical device number (ldn) 
that you want to assign to the SSLC. This information is needed during the configuration dialogue. 


The programs that constitute the HP 2780/3780 Emulator are supplied in one of two ways: 

® On the MPE Master Installation Tape (MIT) under groups HP 30131 and HP 30130 of the Support Account. 

® On two reels of magnetic tape (Maintenance Tapes). One contains CS/3000 (HP 30131); the other, RJE (HP 30130). The 
programs are in STORE format and must be RESTORED to the Support Account in groups HP 30131 and HP 30130 
respectively. 

Each group (HP 30131 and HP 30130) contains an unnumbered instruction file named INSTRUCT which can be listed using 

Editor/3000. INSTRUCT in HP 30131 summarizes Emulator configuration, and lists the necessary MPE program and library 

changes. INSTRUCT in HP 30130 tells how to prep and save RJE, and how to run a test program which exercises the RJE 

facility. 

The MPE Operating System is modified during Emulator configuration. The changes are made during a SYSDUMP operation 

and the tape generated is subsequently used to COLDSTART the system. If configuring one or more SSLCs is the only 

modification to be made during the SYSDUMP, the instructions in this appendix are complete. If additional changes are to 

be made, you may need to refer to the System Manager/System Supervisor Reference Manual. The step numbers in the 

following dialogue correspond to the System Modification step numbers given in Section VI of that manual. 


Special consideration must be given to the method of communication employed at your facility so that you will know 
whether to establish full or half duplex mode during the Configurator/User Dialogue. 


FULL DUPLEX Mode. Configure the Emulator to operate in full duplex mode if your facility uses one of these: 
@ A leased line with a four wire point-to-point installation. 

@ A dial network with two lines (four wire). 

@ A dial network with Wide Band Service. 

In the Configurator/User dialogue, the following prompts are relevant to full duplex configuration: 


SUB TYPE? 0 or 1 (Step Number 3.10) 
TRANSMISSION MODE? 0. (Step Number 3.27) 


HALF DUPLEX Mode. Configure the Emulator to operate in half duplex mode if your facility uses a dial network with a 
single-line (two wire) installation. 


In the Configuration/ User dialogue, the following prompts are relevant to half duplex configuration: 


SUB TYPE? 0 (Step Number 3.10) 
DIAL FACILITY? YES (Step Number 3.20) 
ANSWER FACILITY? YES (Step Number 3.21) 
AUTOMATIC ANSWER? YES or NO (Step Number 3.22) 
TRANSMISSION MODE? 1 (Step Number 3.27) 
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CONFIGURATION DIALOGUE 





In the dialogue, return underlined means you should press the RETURN key in response to the prompt. Also, all responses 
are underlined to distinguish them from computer prompts. Some responses are shown as YES or NO; you can type Y or N 
instead. 


Log on the Support account, define the output device files, and initiate the System Modification dialogue: 


‘HELLO FIELD.SUPPORT,HP30131 ~<—- The Support account must have System Manager capability in order to perform a 
system dump. If it does not, log on under the MANAGER.SYS account. 

‘FILE T;DEV=TAPE 

‘FILE L;DEV=LP 

:SSYSDUMP *T, *L 


Step No. Dialogue 
1 ANY CHANGES? YES 
2 SYSTEM ID = HP 32002.v.uu.ff.? return 
3 MEMORY SIZE = xxx.? return ) 
3.1 I/O CONFIGURATION CHANGES? YES 
3.2 LIST 1/0 DEVICES? YES 
All I/O devices currently configured on the system are listed with the following column headings: 
LOG DEV Logical device number 
DRT # Hardware device address of SSLC 
UNIT # Always 0 for SSLC =~ 
CHAN Always 0 for SSLC 
TYPE Device type, always 18 for SSLC 
SUBTYPE Device subtype 
TERM TYPE Terminal type 
REC WIDTH Record width, decimal words 
OUTPUT DEV Device class name or device Idn 
MODE J = Accept jobs 


A= Accept data 

I = Interactive device 
D = Duplicative device 
S = Spooled device 





DRIVER NAME CSSBSCO for SSLC 
DEVICE CLASSES Class names assigned to SSLC 
3.3 LIST CS DEVICES? YES 


This prompt appears only if a CS device is currently configured in the system. The list of CS 
devices is printed with the following column headings: 


LDN Logical device number 
PM Always 0 for SSLC 
PRT Protocol 

LCL MOD Local mode 

TC Transmission code 
RCV TMOUT Receive timeout 

LCL TMOUT Local timeout 

CON TMOUT Connect timeout 
MODE O = Dial out 


I = Manual answer 
A= Automatic answer 
D = Dual speed 

H = Half speed 

C = Speed changeable 
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Step No. 


3.4 


3.9 


3.6 


3.7 


3.8 


3.9 


3.10 


3.14 


3.15 


3.16 


Configuring the Emulator 
Dialogue 
TRANSMIT SPEED Transmission speed (char per sec) 
T™ Transmission mode 
BUFFER SIZE Default buffer capacity, in words 
DC Driver changeable or not changeable 
DRIVER OPTION Driver options 
HIGHEST DRT = xx.? 


xx denotes the current highest hardware device number that can be assigned. Enter return if the 
number displayed is large enough to include the SSLC (or SSLCs) you are adding. Otherwise, enter 
a higher DRT number. 


LOGICAL DEVICE #? /2 
Enter the logical device number of the particular SSLC board being configured. This prompt is 
repeated later in the modification dialogue so that you can return to this point to configure 
more than one SSLC. 


DRT #? $ 
To add an SSLC, enter its hardware device address. 
UNIT #? O- (Always 0 for SSLC) 
CHANNEL #? 0 (SSLC does not use selector channel) 
TYPE? 18 (Always 18 for SSLC) 
SUB TYPE? 


0 = Point-to-point switched line with modem (telephone dial network). A zero subtype enables 
“data set ready” causing you to receive the dial and answer prompts in Steps 3.20 through 
3.22. 


1 = Point-to-point nonswitched line with modem (leased line, 4-wire). When subtype equals 1, 
Steps 3.20 through 3.22 are skipped. 


PROTOCOL? 1 (Binary Synchronous Communications) 


LOCAL MODE? 
1 = Local is a primary contention station 
2 = Local is a secondary contention station 


To resolve the contention problem in point-to-point operations, each station is assigned a priority 
(primary or secondary). Because the secondary station can gain control of the line for a transmis- 
sion only when the line is left free by the primary station, the Emulator is usually configured as a 
primary station. 


Local mode determines the amount of time a local station will wait in response to a line bid; 
primary station timeout is two seconds and secondary is three seconds. If a response from the 
remote system is not received within the allowed time (two seconds for primary or three seconds 
for secondary), the line bid is re-transmitted until the number of retries permitted by the Emulator 
is exhausted. 


TRANSMISSION CODE? 
1 = Automatic code sensing of ASCII and EBCDIC if initially receiving; ASCII if initially sending. 
2 = ASCII 
3 = EBCDIC 


Select the most frequently used method of transmission because your response establishes the con- 
figuration default. Users not transmitting by the default method can use the LINECODE= param- 
eter of the #RJLINE command to override this specification. 
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Step No. Dialogue 





3.17 RECEIVE TIMEOUT? 
A number, 0 to 32000. Default is 20 seconds. 


Your response establishes the number of seconds the Emulator will wait to receive communication 
before terminating the read mode. A Zero response disables the timeout feature. 


This timeout is set when an ACK is sent to the remote system. Return communication is expected 
from the remote system in the form of text, EOT, or TTD. 


If a timeout occurs, a batch job terminates and the Emulator displays an error message on the 
system console. 


In session mode, the Receive Timeout is disabled. 


3.18 LOCAL TIMEOUT? 
A number, 0 to 32000. Default is 60 seconds. 


Your response establishes the number of seconds a connected local station will wait to transmit or - 
receive before disconnecting. A zero response disables the timeout feature. 


This timeout promotes efficient line use by timing between requests to the SSLC driver. 


In session mode, the Local Timeout is disabled. 


3.19 CONNECT TIMEOUT? 
A number, 0 to 32000. Default is 900 seconds. 


Your response establishes the number of seconds the local station will wait after one attempt to of 
make a connection to a remote station. A zero response disables the timeout feature. 


The “data set ready” signal must indicate the communications link is established within the allot- 
ted time, otherwise, a timeout occurs. 


The Connect Timeout is disabled when a user, working in session mode, includes the optional 
CONNECT=ANSWER parameter in an #RJLINE command. 


The Connect Timeout is operational when a user specifies CONNECT=ANSWER from a job (in 
batch mode). 





NOTE 


If the SSLC was configured as subtype 0 in Step 3.10 (it is connected 
with a switched telephone line through a modem), continue with Step 
3.20. 


If the SSLC was configured as subtype 1 in Step 3.10 (it is connected 
with a non-switched leased line through a modem), skip to Step 3.23. 


3.20 DIAL FACILITY? eG 
YES Calls can be dialed from the local station. yi 
NO Calls cannot be dialed. 
gh? 
3.21 ANSWER FACILITY? u\ 


YES Local modem can answer calls, either manually or automatically. 
NO Calls cannot be answered. After a NO response, the dialogue skips the next step. 





3.22 AUTOMATIC ANSWER? 
YES Local modem can answer calls automatically. 7 


2 


NO Modem cannot answer calls automatically. 
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3.23 


3.24 


3.25 


3.26 


3.27 


3.28 


3.29 


3.30 


3.50 


3.51 


3.52 


3.53 


3.54 


3.95 


Configuring the Emulator 


Dialogue 
DUAL SPEED? 


YES Local modem is dual speed (European models). 
NO Local modem is single speed. Dialogue skips to Step 3.25 after a NO response. / O 


HALF SPEED? (This prompt is relevant only to European models.) 
YES Modem operates at half speed. 
NO Modem operates at full speed. 
After you respond to this prompt, the dialogue skips to Step 3.26. 
SPEED CHANGEABLE? NO (Always NO for SSLC) 


TRANSMISSION SPEED? 
Enter the line transmission speed, expressed as characters per second. 


Baud Rate Characters per Second 





The transmission speed you specify is ignored for modems that provide internal clocking signals. 
This allows modems of different speeds to be used without reconfiguring the Emulator. 


TRANSMISSION MODE? 
0 = Full duplex 
1 = Half duplex 


Your response must agree with the host system’s configuration and with the characteristics of the 
communication line. (Refer to the beginning of this appendix for more information about trans- 
mission modes.) 


PREFERRED BUFFER SIZE? 1024 
Buffer size, in words, not greater than 4096. The RJE Subsystem will override your specification 
with a suitable buffer size, depending on 2780/3780 emulation. 


DRIVER CHANGEABLE? NO 
DRIVER OPTIONS? 0 
DRIVER NAME? CSSBSCO 
CONTROL LENGTH? 0 


PHONELIST? NO or YES 
Phone lists are not used by the Emulator Subsystem. However, you can supply one number (usu- 
ally a frequently dialed number) which will be the system default. A NO response causes the next 
step to be skipped. 


PHONE NUMBER? 
Enter a string of numbers and hyphens not more than 20 characters in length. 


LOCAL ID SEQUENCE? return 
The Emulator subsystem does not use configured ID sequences. An ID sequence is transmitted 
only when a user includes the optional ID= parameter in the #RJLINE command. 





REMOTE ID SEQUENCE? return 
The Emulator ignores all ID sequences sent by a remote processor. 
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3.70 


3.5 


3.80 


3.81 


3.82 


3.83 


3.93 


3.94 


10 


10.1 


11 


11.1 


11.2 


11.3 


11.4 


Dialogue 


DEVICE CLASSES? RJLINE (see note) 
Note: You must specify RJLINE, but you may follow RJLINE with additional names. Names 
should be meaningful, up to eight alphanumeric characters, and begin with a letter. Separate the 
names with commas and terminate your list with return. 





LOGICAL DEVICE #? 
This prompt repeats the original Step 3.5 prompt. If you plan to add another SSLC, enter the 
logical device number for the second board to return to the original Step 3.5. If configuration is 
complete, press return to continue with Step 3.80. 

MAX # OF OPEN SPOOLFILES = xx.? retum 

LIST 1/O DEVICES? YES 

LIST CS DEVICES? YES 

CLASS CHANGES? return 

LIST I/O DEVICES; return 

ADDITIONAL DRIVER CHANGES? return 


SYSTEM TABLE CHANGES? return 


MISC CONFIGURATION CHANGES? retum 





LOGGING CHANGES? return 


DISC ALLOCATION CHANGES? return 





SCHEDULING CHANGES? return 


SEGMENT LIMIT CHANGES? return 





SYSTEM PROGRAM CHANGES? YES 
A YES response assumes this is the first time an SSLC has been configured into the system. If an 
SSLC already exists, respond NO and skip to Step 11. 


ENTER PROGRAM NAME, REPLACEMENT FILE NAME? CSSBSCO,P06P131A.HP30131.SUP- 
PORT 


Er D 


SYSTEM SL CHANGES? YES 
A YES response assumes this is the first time an SSLC has been configured into the system. If an 
SSLC already exists, respond NO and skip to Step 12. 

LIST LIBRARY? NO 

DELETE SEGMENT? NO 

REPLACE SEGMENT? NO 


ADD SEGMENT? YES 
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Step No. 





11.4.1 


12 





12.1 


13 





Configuring the Emulator 
Dialogue 


ENTER SEGMENT NAME, USLFILE NAME [,S/C/P]? 
2?COMS YS1,U00U131A.HP30131.SUPPORT,S 
2COMSYS2,U00U131A.HP30131.SUPPORT,S 
2COMSYS3,U00U131A.HP30131.SUPPORT,S 
2?COMSYS4,U00U131A.HP30131.SUPPORT,S 
2COMSYS5,U00U131A.HP30131.SUPPORT,S 
?COMSYS6,U00U131A.HP30131.SUPPORT,S 
2?COMSYS7,U00U131A.HP30131.SUPPORT,S 
?CSUTILITY ,U01U131A.HP30131.SUPPORT,S 
?BSCLCM,U03U131A.HP30131.SUPPORT,S 
?BSCSLCPO,U04U131A.HP30131.SUPPORT,S 
?DVRSSLC,U05U131A.HP30131.SUPPORT,S 
?return 





ENTER DUMP DATE? retum 
return Dumps current I/O configuration, MPE, and PUB.SYS only. When this tape is used 
for COLDSTART, the account structure and all files remain intact. 
future date Dumps current I/O configuration, MPE, and the account structure (but no files). 
current date Dumps current I/O configuration, MPE, the account structure, and all files modi- 
fied since the last SYSDUMP. 
0 Dumps everything. 





LIST FILES DUMPED? NO 


The System Operator must now use the =REPLY command to assign the magnetic tape device on 
which you have arranged for a fresh tape reel to be mounted. 


After the SYSDUMP is complete, the tape produced should be used to COLDSTART the system. During COLDSTART, the 


old 1/O device configuration is replaced with the new one from your SYSDUMP tape. 
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SUMMARY OF 
ERROR MESSAGES |[_F | 


The more frequent of the HP 2780/3780 Emulator error messages are summarized in Table F-1. Section V of this manual 
contains a more complete and detailed description of error messages. 


Table F-1. Emulator Error Messages 


MESSAGE MEANING 


*#** COMMAND FILE ERROR: x,yy 
****INPUT FILE ERROR: x,yy 

**** LIST FILE ERROR: x,yy 

**** PUNCH FILE ERROR: x,yy 
**** QUT FILE ERROR: x,yy 
****SOURCE FILE ERROR: x,yy 










The specified file could not be opened, closed, read from, written into, or 
(in the case of the LIST, PUNCH, or OUT files) was not large enough. 






















x: 0 = FOPEN error. 

1 = FCLOSE error. 
2 = FREAD or FWRITE error. 
3 = Ran out of file space. 












FCHECK error code 









**** COMMAND ERROR: 0 





Invalid command (the command was totally unrecognizable). 









**** COMMAND ERROR: 1 Command too long. 










**** COMMAND ERROR: 2 Too many parameters. 


*#** CS ERR 0,11 or 0,13 Line is in use or unavailable for some reason. 


EE CS ERR 0, 12 Erroneous x in :FILE RJLINE;DEV=x file equation 

or 

no :FILE RJLINE;DEV=x file equation was issued and there is no 
Synchronous Single Line Controller (SSLC) with the device class name 
RJLINE. 


****CS ERR 1,57 or 2,57 You (or the computer operator) entered NO in response to the DIAL 
REQD message. 


**eKECS ERR 1,101 or 2,101 The Synchronous Single Line Controller (SSLC) failed to respond to an I/O 
instruction. 
****CS ERR 1,102 or 2,102 or 1,105 or 2,205] A parity error occurred on the SIO-bus. 















****CS ERR 1,103 or 2,103 The Data Set Ready (CC) signal from the MODEM has dropped (changed 
from “set” to “clear”). 


**CS ERR 1,153 or 2,153 or 2,203 or 2,204| Line bid refusal. The remote processor responded with a NAK or EOT when 
the Emulator tried to initiate a transmission. 
**** CS ERR 1,158 or 2,158 A DLE-EOT sequence was received. 


*#** CS ERR 1,201 or 2,201 Operator abort. The computer operator of your HP 3000 Computer System 


entered an =ABORTIO command for the Synchronous Single Line 
****CS ERR 1,209 










CONTROLLER. 






Receive Text time-out. No data was received within the allowed time 
(20 seconds). 
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MESSAGE MEANING 
*KECS ERR 1,217 Line Bid time-out. The remote processor did not bid for the line within 
the allowed time (3 minutes or the specified WAIT= time). 
KECS ERR 2,205 An ENQ was received in response to a line bid. 


*#** CS ERR 2,206 








Transmit mode only. 


An RVI was received when a positive or negative acknowledgement 
(ACKO, ACK1, WACK, or NAK) was expected. 


***ECS ERR 2,207,2 An irrecoverable parity error occurred on the transmission line. 


*kEECS ERR 2,207,4 Line bid time-out. The remote processor did not respond within 15 retries 
(48 seconds) when the Emulator tried to initiate a transmission. 





Write Continue time-out. The remote processor did not respond to a 


transmission block within 15 retries (48 seconds). 


**CS ERR 2, 210 Transmit mode only. 
An EOT was received when a positive or negative acknowledgement | 
(ACKO, ACK1, WACK, or NAK) was expected. 


**** TINE ERROR: 0 You tried to perform remote I/O without having established the line (you 
forgot to issue an #RJLINE command). 


**** PROCEDURE ERROR: xx Kither the Emulator could not find the specified procedure or something 
was wrong with the procedure. 





xx: Loader error code. This code is described in the Loader Errors table 7 5 
under MPE Diagnostic Messages in the MPE Intrinsics Reference Doistent 
Manual. 


**k*EERIN ERROR: 0 You used an invalid resource identification number (RIN) or an invalid RIN 
password. 


**** ROUTING ERROR: 0 Routed list output data set was received when it was not expected. 





**4** ROUTING ERROR: 1 Routed punched output data set was received when it was not expected. 
*#** SYNTAX ERROR: 0,x Invalid keyword. x specifies erroneous parameter. 

*#**S YNTAX ERROR; 1,x Duplicate keyword. x specifies erroneous parameter. 

*EFESYNTAX ERROR: 2,x Invalid command construction. x specifies erroneous parameter. 

**X**E SYNTAX ERROR: 3,x Invalid parameter. x specifies erroneous parameter. 

FAEESYNTAX ERROR: 4,x Invalid numeric parameter. x specifies erroneous parameter. 


FEEESYNTAX ERROR: 5,x Required parameter missing. x specifies missing parameter. 
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OUTPUT PROCEDURE 
s 


Figure G-1 shows an example of a procedure used on output-type commands such as #RJPUNCH. This is a generalized 
version intended to show the structure used for an output procedure. Based upon this structure, you ean write your own 
procedure as required by your particular application. As shown by a COMMENT in the example, you would enter your own 
code to process data at line 26. 


The procedure is privileged and as such requires the PM capability for Account, Group, and User. 


Note: When this or any procedure attempts to expand the locked stack, a 
System Failure 150 results. To prevent this, you can use the LOCK= 
NO parameter in the #RJLINE command to allow for stack expansion 
or the RJE Emulator can be prepared (:PREP or :PREPRUN) with a 
larger STACK= parameter (refer to JOOJ130C). 


The procedure takes each received block and writes it into RTNDATA. The Emulator provides the user with ten words of 
global storage from DB+0 to DB+9: this storage area is initialized to zeros. You should: 


@ Compile the procedure. 
@ Put USL into the appropriate SL using SEGMENTER. 
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00001000 
90002000 
00003000 
00004000 
00005000 
00006000 
090007000 
00008000 
00009000 
09010000 
00011000 
00912000 
00013000 
009014000 
90015000 
99016000 
00017000 
00018000 
90019000 
00920000 
90021000 
90022000 
09023000 
90024000 
00025000 
09026000 
00027009 
00028000 
V0029000 
90930000 
00031000 
00032909 
00033000 
0909034000 
00035900 
09036000 
00937900 
09038000 
9000399000 
090040000 

PRIMARY 

NO. 


OM00N 
090000 
0N000 
00000 
00000 
00000 
00000 
0nn00 
HI)0D0 
VOOQ0O 
00000 
QON000 
OOOU0 
onnnnd 
VQOO0d 
NNNNg 
O00N0 
NQgqQ7 
QNNY7 
09074 
09033 
09032 
00034 
00034 
00037 
090037 
00037 
N0044 
vN0 4S 
09047 
90047 
00053 
00054 
00054 
00054 
90061 
00063 
00063 
00003 
00000 


DB STORAGE=Z0003 
ERRORS=0003 
PROCESSOR JTIMFE=03900:01;37 
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SCONTROL SUBPROGRAY, PRIVILEGED, SEGEEIKTSPUS CHE RUC 
REGIN 


TNTRINSIC FOREN, FAPITE,FCLOSE,FCHECE,QUIT: 
PROCEDURE Pu&CHPRIC (TARGET,COUN) ); 


VALUE CUUNT; 
TiTEGER COUNT; 


ARRAY ‘TARGET? 

NPTION PREVELEGED,UNCA&LLAKELE ¢ 
BEG Lh 

LhUGICAL FPILRGPEN = URF0; 

ISTEGER FIJLENUM = yREeT 3 


LuTFEGER fs 
RYTh APRAY FILEWAVE (OST)? 


[rer UOT FIRE GPE Tepe, 
Re GIN 
AUVE FTUEwASk s= "RY YOIATA rs 


PULENUM g= FOPRWC(FILERANE ,O,j) 78 
[F <> THky GU BRreOR: 
FIJLEOPER: ss TKR? 
END? 
TF CuoUNT 
BREGTA 
COMMENT USER CODE Te PPUCESS € 
Pak] TR CR IORS UY, PARGET, CURT, O) 


<> 0 Takis 


ATLA; 


TF <> THEY GO bkePROR; 
BD BOSE 
BEGIN CC END MR RDATI >> 


FCLOSEC(FILENU4,1,0);3 
TE <> THeix 
BEGIS 
ERROR: 
FCHECK(FILENA, NH) s 
QUIT CN); 
END; 
Ends 
END; << 
EWD, 


PUNCHPPOC >> 


SECUNDARY DB STURAGE=Z0COCO 
hO. WARNTWGS=000 
ELAPSED TIME=0200213 


Figure G-1. Sample Output Procedure 
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APPENDIX 


The CS/3000 Trace Facility can provide a record of the line actions, states and events that occur during Emulator operation. 
When problems occur during operation, the trace facility provides the means to pinpoint the problem area. 


The Emulator’s internal procedures for controlling the line are called CS intrinsics. There are four of these procedures, called 
CREAD, CWRITE, CCONTROL and CCLOSE. CREAD is used when the Emulator issues a read to the line. CWRITE is used 
when it issues a write. CCONTROL is used to change the characteristics of the line, to reset and to disconnect. CCLOSE 
releases the line back to the system. 


Each CS intrinsic call generates a series of actions, states and events. An action is something that the CS driver performs, 
and an event is an external happening that requires an action from the driver according to the driver’s state. 


The trace facility is invoked only at the user’s request. Tracing can be invoked for any communication line that the Emulator 
uses. The trace request is made at the time when an RJLINE line is opened. 


Once invoked for a particular communications line, the trace facility continues to record line activity until either the 
Emulator terminates or the user issues a new RJLINE command. The trace facility keeps track of actions, states and events 
in the form of trace entries. 


The trace entries are grouped into trace records: one trace record for each CREAD, CWRITE, CCONTROL or CCLOSE 
intrinsic call by the Emulator. The trace records are permanently stored in a user-specified trace file. The contents of a 
CS/3000 trace file can be formatted and printed through the use of a trace dump utility program (described later in this 
appendix). 


DEFINING THE TRACE FILE 


To define the trace file, enter the following MPE command prior to running the Emulator: 


: FILE CSTRACE= file name 


If no file named CSTRACE exists in your group and no file equation is specified, the Emulator builds one. If CSTRACE al- 
ready exists, it will be used by overwriting the existing entries. The file must be purged and rebuilt in order to change any file 
characteristics (for example, numentries). Renaming the file(s) and using a file equation is useful for retaining the trace file 
and for allowing various users to trace in the same group without interference. 


INVOKING THE TRACE FACILITY 


To invoke the CS/3000 trace facility, include the following trace parameter in the RJLINE command: 


- TRACE -| ALL] : [ mask | E [numentries ||, wear] 


where 


ALL 

generates trace records for all CREAD, CWRITE CCONTROL and CCLOSE requests. If ALL is not specified, then trace 
records are written only when a CREAD, CWRITE, CCONTROL or CCLOSE procedure is completed with a transmission 
error. If ALL is omitted, only I/O errors are traced. ERROR appears on the trace listing. 
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mask 
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is an octal integer preceded by a % sign (%nn). It consists of six bit positions (bits 0 to 5) representing the two-digit (nn) 
mask field. From bits 0 to 5 below, select the type of trace entries required and enter two octal numbers derived from the bit 


values: 


Bit 0 = Generate STN entries (octal 40) 
Bit 1 = Generate OPR and EDT entries (octal 20) $ First octal digit 


Bit 2 = Generate RCT entri 1 a 
i enera entries (octal 10) 012345 
first second 
Bit 3 = Generate RTX entries (octal 4) digit digit 


Bit 4 = Generate SCT entries (octal 2) 
Bit 5 = Generate STX entries (octal 1) 


Second octal digit 


Note: CMP entries are generated automatically. If bits 0 through 5 are set to all zeros, all entry types except STN 


are generated. 


numentries 


is a decimal integer for the maximum number of trace entries in a trace record, but not greater than 255. If set to zero, there 
are a maximum of 25 trace entries per trace record. 


WRAP 


causes trace entries that overflow the trace area (greater than numentries) to overlay the prior trace entries. If WRAP is 
omitted, overflow trace entries are discarded, and NOWRAP appears on the trace listing. 


If only line I/O errors are to be traced, and ALLis not specified, the trace facility deposits in the trace file only those records in 
which a line I/O error occurred. The types of entries described for mask are explained later in this appendix. 


If WRAP is specified then entries are deposited in a trace record in a circular pattern. For example, with a maximum of 35 
trace entries per trace record, trace entries beyond the 35th will overlay the first, second, third (and so on) trace entries in the 
record. When this happens, the overlaid trace entries will be missing from the listing; a warning message will appear at the 


start of the record in the listing stating that the records are missing. 


THE TRACE FILE 


Refer to Section II of the MPE Intrinsics Reference Manual for a description of the FOPEN and FCLOSE intrinsic calls. If 
tracing has been requested, the CS/3000 trace facility issues an FOPEN intrinsic call with the following parameters: 


Parameter 
Formal File Designator 


FOPTIONS Bits 14,15 
Bit 13 
Bits 10,11,12 
Bits 8,9 
Bit 7 


AOPTIONS Bits 0 to 7 
Bits 12 to 15 
Bit 11 
Bit 10 
Bits 8,9 
Bits 0 to 7 


BLOCKFACTOR 


Value 
CSTRACE 


11 
0 
111 
11 
0 


00000000 
1111 

0 

0 

00 
00000000 


1 
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Meaning 


Old file 

Binary file 

Use actual file designator 
Variable length records 
No carriage control 


None 

Write only; purge old contents 

No multi-record option 

Disallow dynamic locking/unlocking 
Exclusive access 

None 
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If the trace file cannot be opened because it does not exist, then a new file is opened in the system domain. If an error occurs 
when trying to open the trace file, the particular RJLINE command fails and the trace file printout will be displayed on the 
user’s session/job output device. 


When the line is closed, the CS/3000 trace facility issues an FCLOSE intrinsic call with the following parameters: 


Parameter Value Meaning 
DISPOSITION 1 Save 
SECCODE 0 Unrestricted access 


TRACE DUMP PROGRAM 


There is a CS/3000 trace dump utility program (CSDUMP) in the Systems Account that formats and prints the contents of 
the trace files generated by the CS/3000 trace facility. The trace dump program requires a trace file and a list file. 


LIST FILE 


The formal file designator of the list file is LIST. The list file may be defined as a CRT terminal, a line printer, or a disc file. To 
define the list file, enter an MPE :FILE command prior to invoking the trace dump program. Some typical examples are: 


:FILE LIST; DEV=LP (LP is assumed to be the device class name for one or more line printers) 
:FILE LIST;= FILENAME (FILENAME is assumed to be the name of an old temporary or permanent disc file). 


If a list file does not exist or is not designated by a :FILE command, and PARM of the RUN command is not a one, the trace 
dump program employs the user’s session/job output device as the list file. If PARM is set to one, then the dump program 
attempts to open the file LIST as an old job or system file. If this fails because LIST does not exist, then LIST is opened as a 
new file in the system domain. After the dump program has run, the contents of this file may be used by the HP Text Editor 
with the /TEXT LIST, UNNUMBERED command. 


INVOKING THE TRACE DUMP PROGRAM 
After the trace and list files have been defined, enter the following command: 


-RUN CSDUMP.PUB.SYS [;PARM=1] 


The trace dump program uses the trace file as input and produces a formatted trace listing on the list file. The format of the 
trace listing is described in the following text. 


FORMATTED TRACE LISTING 


As shown in figure H-1, the trace listing opens with a header message followed by a display box identifying the line being 
traced. The line information display box contains information on the line state at the time of opening. The third box contains 
information on the CS request, in this example a CREAD. Any information on missing (lost) entries would appear after the 
third box. No missing entries are shown in the example. 


Each trace entry is sequentially numbered, starting at zero, and the lapsed time in seconds from line opening (12:01 AM in 
this case) is shown. The body of each entry shows line activity that has happened and is about to happen. Trace entry five 
contains the actual text received (P08) along with the control characters. Trace entry six shows the portion of the message 
(the processed text) and the message format word (MFW) set into the buffer. Trace entry seven summarizes the line activity 
in terms of message activity and errors. The next box shows that the CCLOSE intrinsic call was issued. 


Trace entries 8 to 11 are delay sequences sent by the driver to the remote station while waiting for the next Emulator request. 
Trace entry 12 contains the Emulator request which stops the delay sequence and honors the CCLOSE intrinsic call. Trace 
entries 13 to 15 show the disconnect sequence and message activity. The line information display contains the same type of 
information as in the previous display, updated to reflect the preceding received message. When ALL is not specified only 
errors appear in the line entries. 
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Figure H-1. Sample Trace Listing 
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Figure H-1. Sample Trace Listing (Continued) 
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TRACE LISTING HEADER MESSAGE 





At the start of the trace listing is a header message (figure H-2) that tells the date and time-of-day when the listing was 
printed and the fully-qualified name of the trace file. The meanings of the two remaining items in the header message are: 


Item Meaning 


LAST OPENEDON.... This tells you the date and time-of-day when the trace 
was performed. 


SYSTEM ID=nn.mm This tells you the version number (nn) and the fix level 
(mm) of the MPE/3000 operating system that was 
being used when the trace was performed. 


wee CS TRACE ELA FACILITY 344 Tube JAN Fe 197€¢ Lesat am 
TreaCe Flee [5 CS frace.CS$3U.0C 


LAST GkercvD ON Thre YvaAnNR oe 1G467€- J23U0) Ax 
SYSTem lus2t-e,l/ 


Figure H-2. Trace Listing Header 


BEGIN TRACING AND LINE INFORMATION MESSAGES 


The “BEGIN TRACING . .. .” message appears in the listing when the line to be traced is opened. The message tells you the 
decimal logical device number of the line (32 in the example in figure H-3). It indicates the line’s activities are now being 
monitored by the trace facility. It is followed by the Line Information Display describing the state of the line when tracing 
started. 
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Figure H-3. Begin Tracing and Line Information 
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TRACE RECORD HEADER MESSAGE 





The trace listing is organized into a series of trace records, each consisting of a series of trace entries. Every trace record 
pertains to a particular Emulator request (intrinsic call). 


A trace record is signified by a trace record header message immediately preceding the trace entries. It specifies the decimal 


logical device number of the line being traced (32 in the example in figure H-4), the type of intrinsic, the location in the 
Emulator where the intrinsic was invoked, the line’s state and the Emulator’s calling parameters. 


UPRUHEHUEE HHH NH EEE RAH EEE HAHN HEHHdHEoeE aS 


t CREAD LOGICAL OecvICcE=34 + 
*# CALLERS StGMENT=PrG Yud ALDRESS= 0001E2 2 
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Figure H-4. Trace Record Header 


TRACE ENTRY FORMAT 


All entries in a trace listing contain a prefix consisting of three fields: 





1, An entry number (8 in the example in figure H-5). 
2. A “time stamp” in seconds and thousands of seconds (8.852 in the example). 
3. An entry-type mnemonic (OPR in the example). 


The first entry is numbered zero and successive entries throughout the rest of the listing of this trace are numbered 
consecutively in ascending order (1, 2, 3 and so on). The “time stamp” makes it possible for you to determine the elapsed time 
in seconds and milliseconds between one trace entry and another. The mnemonic tells you what type of trace entry you are 
examining. There are eight types of trace entries, summarized in table H-1 and described in greater detail in following pages 


of this appendix. The body of each trace entry tells you the pertinent information for the particular activity that has 
happened or is about to happen. 





#eeHSeF OPK SENIS CONTROL SEG TREN RECEIVE CONTROL Stee 
SENC SEWIWACLE TIMtOuT= 77200,CUU 
IN BbLER= 0.921145 LENGTH=] 


Figure H-5. Trace Entry 


END OF TRACE AND LINE INFORMATION MESSAGES 





The “END OF TRACE ... .” message appears in the listing when the line being traced is closed. The message tells you the 
decimal logical device number of the line (32 in the example in figure H-6) and indicates that the line’s activities are no 
longer being monitored by the trace facility. It is followed by the Line Information Display, showing the state of the line 
just before tracing was stopped. 
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Figure H-6. End of Trace and Line Information ‘) 


MISSING ENTRIES MESSAGE 


If “MISSING ENTRIES” appears at the start of a trace record in the listing, it means that the record was not large enough to 
accommodate all of the trace entries and some entries were lost. If WRAP was not specified (NOWRAP), then the missing 
entries were at the end just before the CMP entry; otherwise they are missing from the beginning where they were overlaid 
by the trace entries that extended past the end of the record. If the missing entries are crucial: 





1. Purge the trace file. 

2. Change the “number of entries per record” specification by way of the ;TRACE=,,numeniries parameter in an 
#RJLINE command for the line. 

8. Change the MASK field to include only the trace entry types that are required for your particular situation. 

4, Rerun the Emulator. 


OPR (OPERATION) TRACE ENTRIES 


An OPR trace entry is generated each time the physical driver is called upon to perform an operation. An example is shown in 
figure H-7. 


3 €.6le C8¥rR SEND CCATROL Stu TREN RECEIVE text 
SEANAD SEG=ib ACK TIMEOUT= 7200,00b 
OUT cFR= 0,000000 LENLTAN=N 
IN BLFR= 1.000066 LeENGTHE-2Aa _ 


Figure H-7. OPR Trace Entry 
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Item Meaning 
( > SENDCONTROLSEQ.... This item tells you what operation is being performed. 
: SEND SEQ this item tells you what BSC control character se- 


quence, if any, is about to be sent to the remote station 
(ID ACK in the example). 


TIMEOUT This item tells you the starting value of the applicable 
timeout timer. In the example the driver sends a ID 
ACK to the remote station and then waits for a charac- 
ter response. “TIMEOUT= 30.000” specifies that the 
response timeout timer will be activated and set to 30 
seconds. (The value of this parameter is input in 
seconds.) 


OUT BFR=n.mmmmmm This item specifies the memory bank number (n) and 
the octal address (m) of the Emulator/CS output buffer. 


IN BFR=n.mmmmmm This item specifies the memory bank number (n) and 
octal address (m) of the Emulator/CS input buffer. 





LENGTH For output, this specifies the amount of text to be sent 
(+ = words; — = bytes). For input, this specifies the 
maximum amount of text that can be received for this 
message (+ = words; — = bytes). 


Table H-1. Trace Entry Type Mnemonics 


— Entry Type Definition 


Generated each time the physical driver (a segment of the CS driver) is called 
upon to perform an operation. The OPR trace entry tells what operation is to be 
performed. 
















Operation 













Generated each time the driver transfers from one internal state to another. The 
STN entry is for internal HP use and should be ignored by the user. 


State 
Transition 





Editor Generated each time a text message or control character sequence is received 
from the remote station. In the case of a text message, the EDT trace entry shows 
the first 14 words of the Emulator’s buffer; BSC control characters, pad characters, 
and CRC parity sequences are omitted. In the case of a BSC control character 
sequence, the EDT trace entry supplies a mnemonic phrase telling what was 


received. 

















Generated each time a BSC control character sequence is received from the 
remote station. The RCT trace entry shows (in octal) sequentially byte-for-byte 
exactly what was received. 


Receive 
Control 
Sequence 







Send 
Control 
Sequence 


Generated each time the driver sends a BSC control character sequence to the 
remote station. The SCT trace entry shows (in octal) sequentially byte-for-byte 
exactly what was sent. 

















Receive 
Text 


Generated each time a text message is received from the remote station. The RTX 
trace entry shows (in octal) sequentially byte-for-byte exactly what was received. 













Send 
Text 


Generated each time the driver sends a text message to the remote station. The 
STX entry shows (in octal) sequentially byte-for-byte exactly what was sent. 













User 
Request 
Completed 


Generated each time an Emulator request (a CREAD, CWRITE, CCONTROLor 
CCLOSE intrinsic call) is completed. The CMP trace entry summarizes the line 
activity, such as the number of text messages sent and received and the number 
of errors that have occurred. 
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EDT (EDITOR) TRACE ENTRIES 


EDT trace entries are generated to identify received text messages and received BSC control character sequences. An 
example is shown in figure H-8. 


° Eele? EUT RECV TEXT XLOGs=-6 
c0VU,.0U0 1zZ0.NFU 070, N40 
F C & 


Figure H-8. EDT Trace Entry 


In the case of a received text message, the body of an EDT trace entry shows, in octal, the message format word (MFW) and 
the first 13 words of the text message. Regardless of how long the text message is, only one EDT trace entry is generated for 
each received text message. The text message is shown as it appears in the Emulator’s buffer. BSC control characters, pad 
characters, and CRC parity sequences are omitted. XLOG specifies the total number of words or bytes (+ = words; — = bytes) 
deposited into the Emulator’s buffer, consisting of the MFW and received text. The MFW is described at the end of this 
appendix. 


In the case of a received BSC control character sequence, the EDT trace entry includes a mnemonic phrase telling what 
control character sequence was received. (Appendix I contains a description of the BSC “handshaking” sequence and control 
characters.) If the control character sequence was accompanied by ar. ID sequence, the ID sequence is shown in octal below 
the mnemonic phrase. XLOG is normally zero, except in the case when an ID sequence was also received. In the latter case, 
XLOG specifies the length of the ID sequence ( + = words; — = bytes). 


Whenever possible, the trace dump program converts the received octal codes to a character and displays the character 
beneath its code. The translation from code to character is performed for EBCDIC transmissions as well as ASCII 
transmissions. 


In the example in figure H-8, the body of the EDT trace entry is interpreted as follows: 


A text message was received from the remote station. The total number of characters received was six (XLOG=-—6), of which 
two are MFW characters and four are data characters. These characters are: 


200.00 = MF'W (message format word) 
1200=P 0Q60=0 
070 = 8 040 = Space 


RCT (RECEIVE CONTROL SEQUENCE) TRACE ENTRIES 


An RCT trace entry is generated each time a BSC control character sequence is received from the remote station. The body of 
an RCT trace entry shows you sequentially byte-for-byte exactly what was received. An example is shown in figure H-9. 


t 1.926 RCT 620,260 377,377 
9 


Figure H-9. RCT Trace Entry 


Control character sequences are terminated by a trailing pad character (377 octal). When interpreting the body of an RCT 
trace entry, ignore anything following the 377 code. In the example, an ACKO control character sequence was received. The 
octal codes are interpreted as follows: 


020 = DLE 
260 = 0 (060 with parity bit set) 
377 = Trailing pad character 


t ACKO sequence 


Whenever possible, the trace dump program converts the octal codes to a character and displays the character beneath its 
code. The translation from code to character is performed for EBCDIC transmissions as well as ASCII transmissions. 
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SCT (SEND CONTROL SEQUENCE) TRACE ENTRIES 
An SCT trace entry is generated each time the driver sends a BSC control character to the remote station. The body of anSCT 


trace entry shows you sequentially byte-for-byte exactly what was sent to the remote station. An example is shown in figure 
H-10. 


= 0.956 SCT 205,277 
Figure H-10. SCT Trace Entry 
In the above example, an ENQ control character was sent. The octal codes are interpreted as follows: 


205 = ENQ (005 with parity bit set) 
377 = Trailing pad character 


Whenever possible, the trace dump program converts the octal codes to a character and displays the character beneath its 
code. The translation from code to character is performed for EBCDIC transmissions as well as ASCII transmissions. 
RTX (RECEIVE TEXT) TRACE ENTRIES 


RTX trace entries are generated each time a text message is received from the remote station. The body of an RTX trace entry 
shows you sequentially byte-for-byte exactly what was received. An example is shown in figure H-11. 


S 6e7EE RIX Ocd.UUe 120,040 070.0460 020.202 OEE -c40 377,000 
b q be 
277,347 


Figure H-11. RTX Trace Entry 
Most text messages are terminated by a two-byte CRC (cylic redundancy check) parity sequence, while a few may use a 
one-byte LRC (longitudinal redundancy check). This is followed by a trailing PAD character (377 octal). When interpreting 
the body of an RTX trace entry, ignore anything following the 377 code. 


In the example, the octal codes are interpreted as follows: 


020 = DLE 002 = STX 

120 = P 060 = 0 

070 = 8 040 = Space 

020 = DLE 203 = ETX (003 with parity bit set) 


026 = First CRC byte 240 = Second CRC byte 
377 = Trailing pad character 


Each RTX trace entry can show a maximum of 32 bytes. If a text message exceeds this length, as many successive RTX trace 
entries are generated as are necessary. 


Whenever possible, the trace dump program converts the octal codes to a character and displays the character beneath its 
code. The translation from code to character is performed for EBCDIC transmissions as well as ASCII transmissions. 


STX (SEND TEXT) TRACE ENTRIES 
STX trace entries are generated each time the driver sends a message to the remote station. The body of an STX trace entry 


shows you sequentially byte-for-byte exactly what was sent to the remote station. An example is shown in figure H-12. 


13 1,037 STX U2N.002 120.060 070.040 020.203 026,240 377 
P 0 A 


Figure H-12. STX Trace Entry 
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In the example, the octal codes are interpreted as follows: 


020 = DLE 002 =R 

002 = STX 040 = Space 

120 = P 060 = 0 

070 = 8 040 = Space 

020 = DLE 203 = ETX (003 with parity bit set) 


026 = First CRC byte 240 = Second CRC byte 


Each STX trace entry can show a maximum of 32 bytes. If a text message exceeds this length, as many successive STX trace 
entries are generated as are necessary. 


Whenever possible, the trace dump program converts the octal codes to a character and displays the character beneath its 
code. The translation from code to character is performed for EBCDIC transmissions as well as ASCII transmissions. 


CMP (VO COMPLETION) TRACE ENTRIES 


A CMP trace entry is generated each time an Emulator request (a CREAD, CWRITE, CCONTROL or CCLOSE intrinsic call) 
is completed. An example is shown in figure H-13. 


ce 3.332 CMP ERRCR CULE=H210 LAST RECCVERAKLE ERRER CODE= 0 
avss Sth Tsq #MSG RECV=0 STATESCONTROL 
# RKECCVEKASLE ERR=0 # TRRECOVERABLE ERR=0 


Figure H-13. CMP Trace Entry 
The meanings of the various items are as follows: 
Item Meaning 


ERROR CODE The error code of the request’s most recent recoverable error 
(see section V of this manual for error codes). 


LAST RECOVERABLE ERROR CODE If a recoverable error occurred, this identifies its error code. 


#MSG SENT The total number of text messages that have so far been sent 
for this connection. 


#MSG RECV The total number of text messages that have been received so 
far for this connection. 


#RECOVERABLE ERR The total number of recoverable errors that have occurred so 
far for this connection. 


#IRRECOVERABLE ERR The total number of irrecoverable errors that have occurred so 
far for this connection. 


STATE The line state after the completion of the user request. In the 
example it is in the control state. 


SSLC DRIVER MESSAGE FORMAT WORD (MFW) 


All BSC control characters are deleted from the incoming text stream by the driver. The driver describes the received text’s 
format via the message format word (MFW) that is contained in word zero of the user’s buffer. The MFW fields, which have 
the same meaning as in sent text, are as follows: 
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Field 


MF W bit 0 


MFW bit 1 


MFW bit 2 


MFW bit 3 


Note: 


-— © m © 
Hol 


Note: 


CS/3000 Trace Facility 


Meaning 


The received text was transparent. If the text contained ITB’s, 
then this bit means that at least one intermediate text block was 
transparent. 

The received text was non-transparent. 


The received text contained no ITB’s. 

There were ITB’s. The length of each ITB immediately precedes 
its block. The length is a 16-bit quantity and always begins on 
a word boundary. The last ITB is followed by a delimiter word 
set to all ones. 


This field is significant only when there are ITB’s in non- 
transparent text. 


Not all ITB’s began with an SOH or STX character. 
Each ITB was begun with an SOH or STX character. 


The text block ended with an ETX character. 
The text block ended with an ETB character. 


Regardless of whether a text block ends in ETB or ETX, its suc- 
cessful transmission or reception will increment its respective 
“message” counter (MSGSENT/MSGRECV in the CCHECK 
intrinsic). 
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HANDSHAKING 


With BSC and other line protocols of this type, “handshaking” is the term commonly used to describe the interaction between 
stations. Typically the following information is exchanged: 


e Message available for transmission 

e Start of text transmission 

e Acknowledgment or rejection of the text 
e Detection of errors 


e Retransmission after error detection 
e End of transmission 


A simplified handshaking sequence is summarized in figure I-1. This shows handshaking between a terminal and computer, 
but it could also be between two terminals or two computers. In this sequence, a terminal tells a computer it has a message to 
transmit. The computer recognizes the terminal and tells it to proceed with the message. When the computer receives the 
message, it detects an error in the text and requests a retransmission. The retransmission is error-free and the computer asks 
the terminal for another message. The terminal does not have anything more to transmit and so informs the computer. If the 
computer had a message to transmit to the terminal it could now do so. Since it does not, it disconnects from the terminal. 


MESSAGE SEQUENCE 


A message exchange is initiated when a location sends a synchronization (SYN) sequence and an enquiry (ENQ) to another 
location. If the other location can accept a message it acknowledges (ACK) the enquiry. Throughout the handshaking 
sequence, each acknowledgment is alternately numbered one and zero. When an acknowledgment is not received by the 
sender then the next one will be out of sequence and an error detected. As shown in figure I-2, ENQ is transmitted to initiate 
the exchange and the response is ACK 0, even positive acknowledgement. The next step is to synchronize (SYN) the two 
locations. This is obtained by transmitting two or more SYN characters, followed by the message block. 


When the computer looks at the message block it detects an error and transmits a negative acknowledgment (NAK). The 
terminal then retransmits the message block. This time it is error-free and the computer transmits ACK 1, odd positive 
acknowledgment. Synchronization is performed at the start of each message block, and the terminal sends SYN SYN 
followed by the message. The transmission is error-free and the computer responds with ACK 0, even positive acknowledg- 
ment. Since the terminal has no more messages to transmit it sends the end of transmission (EOT) character. Unless the 
computer has something to transmit to the terminal, this completes the exchange and the computer disconnects from the 
terminal. 


The line protocol characters used in the above example represent only a few of the BSC control characters. Table I-1 lists 
character mnemonics along with their meaning and function. 


TERMINAL COMPUTER 


I HAVE A MESSAGE ——> 
—~q#—— GO AHEAD 
SENDS DATA ——}>» 
—~q——- __ ERROR — SEND AGAIN 


RETRANSMITS DATA ——}> 
—~<{——— OK — SEND NEXT ONE 


SENDS END MESSAGE ——>> 
—~{——- _ OK — DISCONNECT 


Figure I-1. Simplified Handshaking Sequence 
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TERMINAL 
SYN SYN (SYNCHRONIZE) 


ENQ (ENQUIRY) 


SYN SYN (SYNCHRONOUS IDLE) 


TRANSMITS MESSAGE BLOCK 


RETRANSMITS BLOCK 


SYN SYN MESSAGE BLOCK 


EOT (END OF TRANSMISSION) 


30130C 
COMPUTER 
—_} > 
—__ > 
EVEN 
—@——  ACKO POSITIVE 
ACKNOWLEDGE 
—_——_ 
> 
NEGATIVE 
—t—_ NAK_ “ACKNOWLEDGE 
—_—___ >> 
ODD 
—<G—— ACK1 POSITIVE 
ACKNOWLEDGE 
——_—_ = 
EVEN 
—@—— ACKO POSITIVE 
ACKNOWLEDGE 
> 


Figure I-2. BSC Handshaking Sequence 


Table I-1. BSC Control Characters 


Character Meaning 
SYN Synchronous Idle 
STX Start of Text 
ETB End of Transmission Block 
US/ATB End of Intermediate 


Transmission Block 


ETX End of Text 
EOT End of Transmission 
ENQ Enquiry 


Function 


Establishes and maintains character synchronization prior to the message 
block. Also used as time fill in the absence of control characters and data. 


Transmitted before the first control characters. These characters contain 
information such as the routing and priority of the message. 


Indicates the end of the text block starting with STX or SOH. BCC is sent 
after ETB, requiring the receiver to respond with ACK, NAK or optionally 
WACK or RVI. 


Divides a message for error checking purposes without the turnaround 
required by ETB. BCC follows ITB and resets the block-check count to 
zero. STX or SOH is not required for following text blocks, but STX is re- 
quired if a header is followed by text. 


Terminates a block of characters, began with SOH or STX, after the last 
block in a sequence of blocks. BCC immediately follows ETX, requiring a re- 
ceiver status reply. 


Concludes transmission, resets all stations to control mode (neither trans- 
mitter or receiver). Also a non-transmit response to a poll and an abort 
signal for a malfunction. 


Bids for the line in a point-to-point and multipoint connection: requests re- 
transmission of last acknowledgment; or preceding block to be 
ignored. Also indicates completion of poll or selection sequence. 
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Table I-1. BSC Control Characters (Continued) 





Character Meaning Function 
*ACK Affirmative Previous block accepted and error-free, receiver ready for next block. Also 
Acknowledgment a positive response to selection (multi-point) or line bid (point-to-point). 
SOH Start of Heading Transmitted before the header characters. These contain information such 


as the routing and priority of the message. 


NAK Negative Acknowledgment Previous block unacceptable and retransmission required. Also a negative 
response to a selection or line bid. 


*TTD Temporary Text Delay Transmitter not ready to commence transmission but wants to maintain 
connection. Sent two seconds after message received to avoid three 
second timeout. Also initiates an abort. 


*RVI Reverse Interrupt Sent to a transmitter by a receiver in place of ACK, indicating the 
receiver has a high priority message waiting transmission. 





*WACK Wait Before Transmit Previous block accepted and error-free, but receiver not ready for next 
Positive Acknowledgment block. Will continue to respond with WACK until ready to receive. Also a 
positive response to a text or heading block selection sequence (multi- 
point), line bid (point-to-point) or identification line bid sequence 
(switched network). 


DLE Data Link Escape Prefix for control characters during transparent mode, when control 
characters have no control meaning unless prefixed by DLE. The two- 
character sequences ACK, WACK, and RVI have DLE as the first 





character. 
DLE EOT Disconnect Sequence Transmitted on a switched line when all message exchanges are 
For A Switched Line complete. Can optionally be transmitted at any time instead of EOT to 
cause a disconnect. 
Pad None Added before (leading pad) a transmission and after (trailing pad) a 
transmission to ensure the first and last characters are properly 
transmitted. 


o *Two-character sequence. 
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EMULATOR FILE OPTIONS 


There are seven Emulator files whose characteristics should be known to the Emulator user. These are: 





Command File 
Input File 

List File 

Out File 

Punch File 

source File 
CS/3000 Trace File 


This appendix describes the above files except for the CS/3000 trace file, which is described in appendix H. For those files 
that can be specified on the :RJE command, the MPE command interpreter issues a :FILE command for each file specified 
by the user. Consequently, the user’s formal file designator effectively overrides the nominal file designator used by the 


Emulator. All files are closed with a security code of zero (unrestricted access). 


FOPEN and FCLOSE intrinsic calls, and the FOPEN parameters AOPTIONS and FOPTIONS, are described in the MPE 
Intrinsics Reference Manual, section II. 


COMMAND FILE 








Parameter 


Formal] File Designator 
FOPTIONS 


Domain Specification 


ASCII/Binary 
Default File Designator 


Record Format 
Carriage Control Option 
File Equation 


AOPTIONS 
Access Type 
Multi-Record Access 
Dynamic Locking 
Exclusive Option 
Inhibit Buffering 


Record Size 
Device 

Forms Message 
User Labels 
Blocking Factor 
Number of Buffers 


Bits 


14,15 


13 
10,11,12 


8,9 
7 
D 


12 to 15 
11 
10 
8,9 
7 


Value 


RJECOM 


%2054 if unspecified 
7 if user-specified 
00 
11 
1 
101 
000 
00 


00 


— 80 
Not passed 
Not passed 
Not passed 
Not passed 
Not passed 
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The command file is opened after the RJE command has been issued. It can be a disc file name; a backward “file reference; 
or unspecified in which case the default is #STDINX. The command file is opened with the following parameters: 


Meaning 


Newfile if unspecified 

Oldfile if user-specified 

ASCII 

$STDINX if unspecified 

Formal designator if user-specified 
Fixed 

No 

Disallow if unspecified 

Allow if user-specified 


Input only 
No 

No 
Default 
No 
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Parameter Bits Value Meaning 
File Size Not passed 
Number of Extents Not passed 
Initial Allocation Not passed 
File Code Not passed 
FCLOSE Disposition Code 0 No change 


If end-of-file or an error is encountered on the command file, then if the command file was not $STDINX it is closed and 
SSTDINX is opened as the command file, with the same options as describe above for unspecified command file. 
Additionally, if the current input file is the same device as $STDINX, the input file is closed and the command and input 
files are accessed as the same file. If the command file was $STDINX, the Emulator terminates. 


INPUT FILE 


The default input file is opened after the :RJE command has been issued, and after the command file has been opened. If 
neither the command file nor the input file is specified by the user, then the command and input files are accessed as the 
same file ($STDINX). Additionally, any time the input file is opened (either the default input file from the :RJE command, 
or an input file specified on a #RJIN command) and is the same as the command file, the input file is closed, and both files 
are accessed as the same file. The default input file is initially opened (following the :RJE command) with the following 
parameters: 


Parameter Bits Value Meaning 
Formal File Designator RJEIN 
FOPTIONS % 2054 if unspecified 
7 if user-specified 
Domain Specification 14,15 00 Newfile if unspecified 
11 Oldfile if user-specified 
ASCII/Binary 13 1 ASCII 
Default File Designator 10,11,12 101 $STDIN if unspecified 
000 Formal] designator if user-specified 
Record Format 8,9 00 Fixed 
Carriage Control Option 7 0 No 
File Equation 5 1 Disallow if unspecified 
0 Allow if user-specified 
AOPTIONS 0 
Access Type 12 to 15 0000 Input only 
Multi-Record Access 11 0 No 
Dynamic Locking 10 0 No 
Exclusive Option 8,9 00 Default 
Inhibit Buffering rf 0 No 
Record Size Not passed 
Device Not passed 
Forms Message Not passed 
User Labels Not passed 
Blocking Factor Not passed 
Number of Buffers Not passed 
File Size Not passed 
Number of Extents Not passed 
Initial Allocation ' Not passed 
File Code Not passed 
FCLOSE Disposition Code 0 No change 


J-2 





30130C 


Emulator File Options 


When the default input file is used (by executing a #RJIN command with no input device or file specification), then if 


REC= is not specified, the default input file is closed when the # RJIN operation completes, and the default input file is set 
equal to the command file. If REC= is specified, then the default input file is left open. 


When #RJIN specifies a device or file, the input file is opened with the following parameters: 


Parameter 


Formal File Designator 


FOPTIONS 
Domain Specification 
ASCII/Binary 
Default File Designator 
Record Format 
Carriage Control Option 
File Equation 


AOPTIONS 
Record Size 


Device 





Forms Message 

User Labels 

Blocking Factor 

Number of Buffers 

File Size 

Number of Extents 
Initial Allocation 

File Code 

FCLOSE Disposition Code 





Bits 


14,15 
13 
10,11,12 
8,9 
7 
5) 


Value 


Meaning 


As user-specified, or not passed 


7 
11 
1 
000 
00 
0 
0 


Not passed 
Not passed 


Old file 

ASCII 

Formal designator 
Fixed 

No 

Allow 


As user-specified, or not passed 


Not passed 
Not passed 
Not passed 
Not passed 
Not passed 
Not passed 
Not passed 
Not passed 
0 


No change 


As noted previously, if the input file opened is the same as the current command file, then the input file is closed and both 


files are accessed as the same file. 


LIST FILE/OUT FILE 





Parameter 


Formal File Designator 
FOPTIONS 


Domain Specification 


ASCI//Binary 
Default File Designator 


Record Format 
Carriage Control Option 
File Equation 


AOPTIONS 
Access Type 
Multi-Record Access 
Dynamic Locking 
Exclusive Option 
Inhibit Buffering 


Bits 


14,15 


13 
10,11,12 


8,9 
7 
3) 


12 to 15 
11 
10 
8,9 
7 


Value 


RJELIST 


%2514 if unspecified 
% 807 if user-specified 
00 
11 
1 
001 
000 
01 


The default list file is opened after the :RJE command has been issued, with the following parameters: 


Meaning 


Newfile if unspecified 

Oldfile if user-specified 

ASCII 

$STDLIST if unspecified 

Formal designator if user-specified 
Variable 

Yes 

Disallow if unspecified 

Allow if user-specified 


Write only, delete old data 
No 

No 

Default 

No 


Emulator File Options 30130C 
Parameter Bits Value Meaning 
Record Size Not passed 
Device Not passed 
Forms Message Not passed 
User Labels Not passed 
Blocking Factor Not passed 
Number of Buffers Not passed 
File Size Not passed 
Number of Extents Not passed 
Initial Allocation Not passed 
File Code Not passed 
FCLOSE Disposition Code 0 No change 


If the FOPEN of a user-specified old file fails, then an attempt is made to open the file new. The following 
parameters are changed from those above: 


FOPTIONS %504 
Domain Specification 14,5 00 Newfile 
File Size 5000 records 


FCLOSE Disposition Code 


1 


Save permanently 


Output will be written to the default list file (the file opened from the :RJE command) under the following conditions: 


e #RJLIST is processed, with no file, device, or list procedure specified, and unrouted output or routed list output is 


received. 


e #RJOUT is processed, with no file, device, or output procedure specified, and unrouted output or routed list output is 


received. 


The default list file is closed when the Emulator terminates. 


When the # RJLIST or #RJOUT specifies a device or file, the list or output file is opened with the following parameters: 


Parameter Bits Value Meaning 
Formal File Designator As user-specified, or not passed 
FOPTIONS %507 If filename 
%504 If logical device or device class 
Domain Specification 14,15 11 Oldfile if device 
00 Newfile if file 
ASCII/Binary 13 1 ASCII 
Default File Designator 10,11,12 000 Formal] designator 
Record Format 8,9 01 Variable 
Carriage Control Option 7 1 Yes 
File Equation 5 0 Allow 
AOPTIONS 1 
Access Type 12 to 15 1 Write only, delete old data 
Multi-Record Access 11 0 No 
Dynamic Locking 10 0 No 
Exclusive Option 8,9 00 No 
Inhibit Buffering 7 0 No 
Record Size Not passed 
Device As user-specified, or not passed 


Forms Message As user-specified, or not passed 


User Labels Not passed 
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Parameter Bits Value Meaning 

a Blocking Factor Not passed 

Number of Buffers Not passed 

File Size Not passed 

Number of Extents Not passed 

Initial Allocation Not passed 

File Code Not passed 

FCLOSE Disposition Code 0 No change 


If the FOPEN of a user-specified old file fails, then an attempt is made to open the file new. The following 
parameters are changed from those above: 


FOPTIONS % 304 
Domain Specification 14,15 00 Newfile 
FCLOSE Disposition Code 1 Save permanently 





Output will be written to the list file specified on # RJLIST if unrouted output or routed list output is received. If an output 
file is specified on # RJOUT, then any received data, routed or unrouted, will be written to it. Note that there is no default 
output file opened on the :RJE command; an output file is opened only when specified on the #RJOUT command. List and 
output files specified on the #RJLIST and #RJOUT command are closed when the command completes processing. 


The value of the control parameter passed to FWRITE for list and output files depends on the received data and, in the case 
of list files specified on # RJLIST, on the specifications of the AUTOPAGE parameter. If received data is non-transparent 
and the first byte of a received logical record is an ESC character (%33 if LINECODE= ASCII, %47 if LINE- 
CODE= EBCDIC), then the following byte is used to determine vertical forms control; otherwise vertical forms control is 
not determined by received data. The following table summarized the conversions used for vertical forms control, according 
to Emulator type and LINECODE: 








2780 3780 HP 3000 

Function ASCII EBCDIC ASCII EBCDIC Control (AUTOPAGE= YES) 
Single Space Q / Q / %201 (% 40) 
Double Space R S R S %202 (%60) 
Triple Space S T 5 T % 203 (% 304) 
Skip to 1 A A A A % 300 
Skip to 2 B B B B %301 
Skip to 3 C C C C %302* 
Skip to 4 D D D D % 303 
Skip to 5 E E E E % 304 
Skip to 6 F F F F %305 
Skip to 7 G G G G % 306 
Skip to 8 H H H H % 307 
Skip to 9 I I %310 
Skip to 10 J J %311 
Skip to 11 K K % 312 
Skip to 12 L L %313 
Suppress Space M M %53 





%If CHNL3= n is specified, the value n+ %277 is used. 
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If vertical forms contro] is not determined by received data, than a value of %40 is used unless AUTOPAGE=NO is 
specified, in that case %201 is used. This is the only case where where omitting the AUTOPAGE parameter is equivalent 
to AUTOPAGE= YES; when vertical forms control is determined by received data, omitting the AUTOPAGE parameter is 
equivalent to AUTOPAGE= NO. 


If offline listing is being performed (the SOURCE parameter of #RJLIST was specified), then the control parameter used 
for FWRITE is 0; unless the SOURCE file FOPTIONS specifies carriage control option, in which case the control 
parameter is 1. 


PUNCH FILE 


The default punch file is opened after the :RJE command has been issued, with the following parameters: 


Parameter Bits Value Meaning 
Formal File Designator RJEPUNCH 
FOPTIONS % 2132 if unspecified 
3 if user-specified 
Domain Specification 14,15 10 Old temporary file if unspecified 
11 Old file if user-specified 
ASCII/Binary 13 0 Binary 
Default File Designator 10,11,12 011 $OLDPASS if unspecified 
000 Formal designator if user-specified 
Record Format 8,9 01 Variable if unspecified 
00 Fixed if user-specified 
Carriage Control Option 7 0 No 
File Equation 5 1 Disallow if unspecified 
0 Allow if user-specified 
AOPTIONS % 102 
Access Type 12 to 15 0010 Write only save old data 
Multi-Record Access 11 0 No 
Dynamic Locking 10 0 No 
Exclusive Option 8,9 01 Exclusive 
Inhibit Buffering 7 0 No 
Record Size 40 
Device Not passed 
Forms Message Not passed 
User Labels Not passed 
Blocking Factor Not passed 
Number of Buffers Not passed 
File Size Not passed 
Number of Extents Not passed 
Initial Allocation Not passed 
File Code Not passed 
FCLOSE Disposition Code 0 No change 


If the punch file is not specified and $OLDPASS was opened but did not have a file code of 1060, then 
$OLDPASS is closed. If this condition occurred or if FOPEN of an old file failed, then an attempt is made to 
open the file new. The following parameters are changed from the above values: 


FOPTIONS % 2120 If unspecified 
0 If user-specified 
Domain Specification 14,15 00 New file 
Default File Designator 10,11,12 010 $NEWPASS if unspecified 
000 Formal designator if user-specified 
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Parameter Bits Value Meaning 
File code 1060 
Fileclose Disposition Code 2 Save temporary file if unspecified 
1 Save permanent file if user-specified 


Output will be written to the default punch file (the file opened on the :RJE command) only if routed punch data is received 
while processing #RJOUT with no file, device, or punch procedure specified. The default punch file is closed when the 


Emulator terminates. 


When #RJPUNCH specifies a device or file, the punch file is opened with the following parameters: 


Formal File Designator 





As user-specified, or not passed 











FOPTIONS 3 If filename 
0 If logical device or device class 
Domain Specification 14,15 11 Oldfile if device 
00 Newfile if file 
ASCII/Binary 13 0 Binary 
Default File Designator 10,11,12 000 Formal Designator 
Record Format 8,9 00 Fixed 
Carriage Control Option 7 0 No 
File Equation 5 0 Allow 
AOPTIONS %102 
Access Type 12 to 15 0010 Write only, save old data 
Multi-Record Access 11 0 No 
Dynamic Locking 10 0 No 
Exclusive Option 8,9 01 Exclusive 
Inhibit Buffering 7 0 No 
Record Size 40, or as specified on OUTSIZE 
Device As user-specified, or not passed 
Forms Message Not passed 
User Labels Not passed 
Blocking Factor Not passed 
Number of Buffers Not passed 
File Size Not passed 
Number of Extents Not passed 
Initial Allocation Not passed 
File Code 1060 
FCLOSE Disposition Code 0 No change 


If the FOPEN of a user-specified old file fails, then an attempt is made to open the file new. The following 
parameters are changed from those above: 


FOPTIONS 0 
Domain Specification 14,15 00 


FCLOSE Disposition Code 


New file 


Save permanently 


Output will be written to the punch file specified on #RJPUNCH if unrouted output or routed punch output is received. 
Punch files specified on the #RJPUNCH command are closed when the command completes processing. 
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SOURCE FILE 


A source file is opened when the SOURCE parameter is specified on the #RJLIST or #RJPUNCH, indicating that an __ ) 
offline list or punch operation is to be performed. The source file is opened with the following parameters: 


Parameter Bits Value Meaning 

Formal File Designator As user-specified, or not passed 
FOPTIONS 7 

Domain Specification 14,15 11 Old file 

ASCII/Binary 13 1 ASCII 

Default File Designator 10,11,12 000 Formal! designator 

Record Format 8,9 00 Fixed 

Carriage Control Option 7 0 No 

File Equation 5 0 Allow 
AOPTIONS Not passed 
Record Size Not passed 
Device As user-specified, or not passed \ 
Forms Message Not passed 
User Labels Not passed 
Blocking Factor Not passed 
Number of Buffers Not passed 
File Size Not passed 
Number of Extents Not passed 
Initial Allocation Not passed , 
File Code Not passed 
FCLOSE Designation Code 0 No change 


The source file is closed when the #RJLIST or #RJPUNCH command completes processing. 
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